zazzy
API reference

Get the authenticated organization's general settings

Returns the authenticated organization's general settings (name, slug, logo). Served through the same `getOrgGeneralSettings` service the in-app settings page and tRPC layer use — the public API is a thin transport over the shared service layer, never a parallel implementation. Requires the `read` scope.

GET
/organization

Authorization

apiKey
AuthorizationBearer <token>

A bearer API key minted in Account settings → API keys. Send it as Authorization: Bearer <token>. The scheme match is case-insensitive; the token is taken verbatim. A missing, malformed, unknown, revoked, or expired key is rejected with an indistinguishable 401.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/organization"
{  "organization": {    "id": "org_01HZY0M2K3",    "name": "Acme, Inc.",    "slug": "acme",    "logo": "https://cdn.example.com/acme/logo.png"  }}
{  "error": {    "code": "UNAUTHORIZED",    "message": "Invalid API key."  }}
{  "error": {    "code": "FORBIDDEN",    "message": "This API key lacks the required 'read' scope."  }}
{  "error": {    "code": "NOT_FOUND",    "message": "Organization not found."  }}
{  "error": {    "code": "RATE_LIMITED",    "message": "API rate limit exceeded. Retry after the window resets."  }}
{  "error": {    "code": "INTERNAL",    "message": "An unexpected error occurred."  }}

List the authenticated organization's members GET

Returns the authenticated organization's members and their roles, newest membership last, paginated with the shared cursor envelope: pass `?limit=` (default 50, max 100) and the `nextCursor` from a previous response as `?cursor=` to page forward. `nextCursor` is `null` on the last page. Requires the `read` scope.

Get the authenticated organization's usage summary GET

Returns the authenticated organization's current-period usage for every metered metric — the amount used, the plan limit (`null` when the metric is unmetered or the plan is unlimited), and the remaining headroom. Served through the same `getUsageSummary` service the in-app usage dashboard reads, so the API and the dashboard always agree. Requires the `read` scope.