Husvo

API-referens

Kalendern

Allt i huset med ett datum, och kalenderprenumerationen.

Finns det en kalenderadress, och sedan när

GET /api/v1/houses/{houseId}/calendar

operationId getCalendarStatus

  • Bearer-token
  • Kräver läsrätt i huset

Parametrar

NamnVarTypKrävs
houseId adressen integer ja

Exempel

curl -X GET "https://husvo.app/api/v1/houses/1/calendar" \
  -H "Authorization: Bearer $TOKEN"

Svar

200 Klart · CalendarStatusDto
{
  "active": false,
  "since": "2026-11-13T08:00:00Z"
}

Fel, som problem+json (felkoderna):

  • 404Finns inte, eller inte för dig

Skapa ny kalenderadress. Visas bara här, och slår ut den gamla

POST /api/v1/houses/{houseId}/calendar

operationId createCalendarKey

  • Bearer-token
  • Kräver redigeringsrätt i huset
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
houseId adressen integer ja

Exempel

curl -X POST "https://husvo.app/api/v1/houses/1/calendar" \
  -H "Authorization: Bearer $TOKEN"

Svar

201 Skapad · CalendarKeyDto
{
  "url": "https://exempel.se/",
  "webcalUrl": "https://exempel.se/",
  "since": "2026-11-13T08:00:00Z"
}

Fel, som problem+json (felkoderna):

  • 403Inte tillåtet

Stäng av kalenderadressen

DELETE /api/v1/houses/{houseId}/calendar

operationId revokeCalendarKey

  • Bearer-token
  • Kräver redigeringsrätt i huset
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
houseId adressen integer ja

Exempel

curl -X DELETE "https://husvo.app/api/v1/houses/1/calendar" \
  -H "Authorization: Bearer $TOKEN"

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 403Inte tillåtet

Parametrar

NamnVarTypKrävs
houseId adressen integer ja
from frågesträngen string nej
to frågesträngen string nej

Exempel

curl -X GET "https://husvo.app/api/v1/houses/1/calendar/events" \
  -H "Authorization: Bearer $TOKEN"

Svar

200 Klart · CalendarEventsResponse
{
  "from": "2026-11-13",
  "to": "2026-11-13",
  "items": [
    {
      "date": "2026-11-13",
      "kind": "text",
      "title": "text",
      "detail": "text",
      "target": "text",
      "targetId": 1,
      "late": false,
      "wholeMonth": false,
      "repeat": false,
      "assigneeId": 1
    }
  ]
}

Fel, som problem+json (felkoderna):

  • 404Finns inte, eller inte för dig
  • 422Kontrollera uppgifterna
Sidan hakade upp sig.Ladda om🗙