Authentication
Send a key, an exchanged token or an OIDC token in the Authorization header.
Every request needs one credential in the Authorization header, except GET /v2/health:
Credentials
Each host accepts only the credentials of its own organization. A key of another organization gets 401 invalid_api_key.
Read the credential
GET /v2/me returns the credential of the request. It needs no scope.
For a crt_ token or a JWT, key.id holds the trust id, and key.hint is empty. The Run issuer of your organization has the trust id self.
Scopes
A credential has a list of scopes. There is one list for the host.
A missing scope gives 403 insufficient_scope. The agent allowlist and the rate cap of a key are restrictions on the key. They are not scopes.
Common errors
Read Errors for all codes.