zazzy
API reference

Get the authenticated key and organization

Returns the API key the request authenticated with and the organization that owns it — an integration can call this to confirm *which* key and org a token resolves to. Requires the `read` scope.

GET
/me

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

curl -X GET "https://example.com/me"
{  "organization": {    "id": "org_01HZY0M2K3",    "name": "Acme, Inc.",    "slug": "acme"  },  "apiKey": {    "id": "key_01HZY0M9QT",    "name": "Production server",    "keyPrefix": "sk_live_9x2Q",    "scopes": [      "read",      "write"    ]  }}
{  "error": {    "code": "UNAUTHORIZED",    "message": "Invalid API key."  }}
{  "error": {    "code": "FORBIDDEN",    "message": "This API key lacks the required 'read' scope."  }}
{  "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 files GET

Returns metadata for the authenticated organization's ready files — newest first — 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. Pass `?purpose=` (`avatar`, `logo`, or `attachment`) to narrow to one purpose. Only files that finished uploading are listed; pending and deleted files are omitted, and no download URLs are returned. Requires the `read` scope.

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.