Havenly
API reference

Havenly REST API

A clean, typed REST surface — JSON in, JSON out. All endpoints are versioned under /v1, secured by a session token, and rate-limited per role.

api.havenly.app · v1.4 · 99.98% uptime

Authentication

POST/v1/auth/session

Exchange role-scoped credentials for a session token.

Request body
{
  "role": "owner"
}
Response · 200
{
  "token": "sess_…",
  "expiresIn": 3600
}
DELETE/v1/auth/session

Revoke the current session.

Response · 200
{
  "ok": true
}