Husvo

API-referens

Händelser

Vad andra i hushållet gjort sedan du tittade.

Vad som hänt i huset, nyast först, med antal olästa

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

operationId listActivity

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

Parametrar

NamnVarTypKrävs
houseId adressen integer ja
limit frågesträngen integer nej
cursor frågesträngen string nej

Exempel

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

Svar

200 Klart · ActivityListResponse
{
  "items": [
    {
      "id": 1,
      "actorName": "text",
      "what": "text",
      "where": "text",
      "createdAt": "2026-11-13T08:00:00Z",
      "unread": false
    }
  ],
  "unreadCount": 1,
  "nextCursor": "text"
}

Fel, som problem+json (felkoderna):

  • 404Finns inte, eller inte för dig
  • 422Kontrollera uppgifterna

Markera allt som läst för mig

POST /api/v1/houses/{houseId}/activity/read

operationId markActivityRead

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

Parametrar

NamnVarTypKrävs
houseId adressen integer ja

Exempel

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

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

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