Status codes - Zenamu Docs

All responses use standard HTTP status codes.

Success

Status	Meaning
`200`	The request succeeded. The payload is under `data`.

Bulk grants return 200 even when some items failed. Read results[].success per item — see Errors.

Errors

Status	Meaning
`400`	A required parameter is missing, the `Authorization` header is malformed, or body validation failed.
`401`	No API key was sent.
`403`	The key is valid, but your plan does not cover the endpoint or a targeted non-default pass group. See Plans and access.
`404`	The API key was not recognized, or the client in the path is not in your studio.
`429`	You exceeded 100 calls per minute on this endpoint. See Rate limits.
`500`	An unexpected server error. Retry with backoff if the call is safe to repeat.

404 carries two very different meanings. On a list endpoint it can only be an unrecognized API key. On /v1/clients/{clientId}/credits it can also mean the client does not exist in your studio. Read the message to tell them apart.