Husvo

API-referens

Kontot

Den inloggade: namn, enheter, inbjudningar och radering av kontot.

Inbjudningar till mitt konto som väntar på svar

GET /api/v1/me/invites

operationId listMyInvites

  • Bearer-token

Exempel

curl -X GET "https://husvo.app/api/v1/me/invites" \
  -H "Authorization: Bearer $TOKEN"

Svar

200 Klart · MyInviteListResponse
{
  "items": [
    {
      "id": 1,
      "houseId": 1,
      "houseName": "text",
      "fromName": "text",
      "role": "text",
      "expiresAt": "2026-11-13T08:00:00Z"
    }
  ]
}

Fel, som problem+json (felkoderna):

  • 401Inte inloggad

Tacka ja till en inbjudan och bli medlem i huset

POST /api/v1/me/invites/{inviteId}/accept

operationId acceptInvite

  • Bearer-token
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
inviteId adressen integer ja

Exempel

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

Svar

200 Klart · MeHouseDto
{
  "id": 1,
  "name": "text",
  "role": "text"
}

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
  • 404Finns inte, eller inte för dig
  • 409Krockar med något som redan finns

Tacka nej till en inbjudan

POST /api/v1/me/invites/{inviteId}/decline

operationId declineInvite

  • Bearer-token
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
inviteId adressen integer ja

Exempel

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

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
  • 404Finns inte, eller inte för dig
  • 409Krockar med något som redan finns

Vem är jag, och vilka hus är jag med i

GET /api/v1/me

operationId getMe

  • Bearer-token

Exempel

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

Svar

200 Klart · MeResponse
{
  "id": 1,
  "name": "text",
  "email": "du@exempel.se",
  "houses": [
    {
      "id": 1,
      "name": "text",
      "role": "text"
    }
  ],
  "ai": {
    "enabled": false
  }
}

Fel, som problem+json (felkoderna):

  • 401Inte inloggad

Byt visningsnamn

PATCH /api/v1/me

operationId updateMe

  • Bearer-token
  • Skrivtaket gäller

Kropp application/json · UpdateMeBody

FältTypKrävs
name string nej
{
  "name": "text"
}

Exempel

curl -X PATCH "https://husvo.app/api/v1/me" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"text"}'

Svar

200 Klart · MeResponse
{
  "id": 1,
  "name": "text",
  "email": "du@exempel.se",
  "houses": [
    {
      "id": 1,
      "name": "text",
      "role": "text"
    }
  ],
  "ai": {
    "enabled": false
  }
}

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
  • 422Kontrollera uppgifterna

Radera mitt konto och min persondata

DELETE /api/v1/me

operationId deleteMe

  • Bearer-token
  • Skrivtaket gäller

Kräver en färsk kod till kontots adress i rubriken X-Confirm-Code (be om den med POST /auth/code). 403 confirmation_required eller invalid_confirmation utan en giltig kod.

Parametrar

NamnVarTypKrävs
X-Confirm-Code rubrik string nej

Exempel

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

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
  • 403Inte tillåtet
  • 409Krockar med något som redan finns

Spara push-token och appversion för den här enheten

PUT /api/v1/me/devices/current

operationId registerCurrentDevice

  • Bearer-token
  • Skrivtaket gäller

Kropp application/json · PushRegistrationBody

FältTypKrävs
pushToken string nej
environment string nej
appVersion string nej
{
  "pushToken": "text",
  "environment": "text",
  "appVersion": "text"
}

Exempel

curl -X PUT "https://husvo.app/api/v1/me/devices/current" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pushToken":"text","environment":"text","appVersion":"text"}'

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
  • 422Kontrollera uppgifterna

Mina inloggade enheter

GET /api/v1/me/devices

operationId listDevices

  • Bearer-token

Exempel

curl -X GET "https://husvo.app/api/v1/me/devices" \
  -H "Authorization: Bearer $TOKEN"

Svar

200 Klart · DeviceListResponse
{
  "items": [
    {
      "id": 1,
      "name": "text",
      "platform": "text",
      "appVersion": "text",
      "createdAt": "2026-11-13T08:00:00Z",
      "lastUsedAt": "2026-11-13T08:00:00Z",
      "current": false
    }
  ]
}

Fel, som problem+json (felkoderna):

  • 401Inte inloggad

Återkalla en enhet. Den egna enheten fungerar som utloggning

DELETE /api/v1/me/devices/{deviceId}

operationId revokeDevice

  • Bearer-token
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
deviceId adressen integer ja

Exempel

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

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
  • 404Finns inte, eller inte för dig

Logga ut överallt, den här enheten också

POST /api/v1/me/devices/revoke-all

operationId revokeAllDevices

  • Bearer-token
  • Skrivtaket gäller

Exempel

curl -X POST "https://husvo.app/api/v1/me/devices/revoke-all" \
  -H "Authorization: Bearer $TOKEN"

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 401Inte inloggad

Mina inloggningar: webbläsare och appen

GET /api/v1/me/sessions

operationId listSessions

  • Bearer-token

Exempel

curl -X GET "https://husvo.app/api/v1/me/sessions" \
  -H "Authorization: Bearer $TOKEN"

Svar

200 Klart · SessionListResponse
{
  "items": [
    {
      "id": "abc123",
      "kind": "text",
      "label": "text",
      "createdAt": "2026-11-13T08:00:00Z",
      "lastActiveAt": "2026-11-13T08:00:00Z",
      "current": false
    }
  ]
}

Fel, som problem+json (felkoderna):

  • 401Inte inloggad

Logga ut en inloggning. Den egna appen fungerar som utloggning

DELETE /api/v1/me/sessions/{sessionId}

operationId revokeSession

  • Bearer-token
  • Skrivtaket gäller

Parametrar

NamnVarTypKrävs
sessionId adressen string ja

Exempel

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

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
  • 404Finns inte, eller inte för dig

Logga ut överallt utom här

POST /api/v1/me/sessions/revoke-others

operationId revokeOtherSessions

  • Bearer-token
  • Skrivtaket gäller

Exempel

curl -X POST "https://husvo.app/api/v1/me/sessions/revoke-others" \
  -H "Authorization: Bearer $TOKEN"

Svar

204 Klart, inget innehåll

Inget innehåll.

Fel, som problem+json (felkoderna):

  • 401Inte inloggad
Sidan hakade upp sig.Ladda om🗙