Reference / Auth
Authenticate server-side requests
Send the workspace API key as a bearer token and keep it out of source control, logs, URLs, and browser code. Framework clients bind it to a separate project ID.Authorization header
HTTPhttp
Authorization: Bearer nsk_...
Content-Type: application/jsonHandle failures explicitly
- 401: the credential is missing or invalid.
- 403: the credential does not have access to the project or capability.
- 422: the request does not match the endpoint contract.
- 429: back off and retry with jitter.
- 5xx: retry only idempotent work and preserve the original request identifier.