API authentication
Authentication with SelectZero API is done using an API key
Example of Authorization header
All requests made to the API must contain Bearer token in request header
Service API keys and personal access tokens
The REST API accepts service API keys only. A service API key is limited only by its scopes. Personal access tokens (PATs) work only with the MCP server; the REST API refuses them with HTTP 403.
Errors
Every error response is JSON with the HTTP status and a message that says what went wrong:
Common statuses: 400 for invalid input or a missing parameter, 403 when the key lacks a scope or is a personal access token, 404 for an unknown id or endpoint, 405 for an unsupported HTTP method (the Allow header lists the supported ones) and 415 for a request body that is not application/json.