UNAUTHORIZED

Missing or invalid credentials.

Authenticate with a Mirai workspace session for Developer Console calls or use a valid Atlas bearer token for public API calls.

FORBIDDEN

The active principal lacks the required developer permission or Atlas scope.

Use an owner workspace account for Developer Console management or re-consent scopes for the external integration.

NOT_FOUND

The referenced org-owned asset does not exist inside the active organization.

Check workspace selection and asset ids. Cross-org lookup is fail-closed.

VALIDATION_ERROR

The request shape is invalid or fails Atlas contract validation.

Use the generated reference and examples from the contract registry.

CONFLICT

The idempotency key or resource uniqueness policy was already used with a different request.

Reuse the same body for the same idempotency key or mint a new key for a new action.

RATE_LIMITED

The endpoint or workspace exceeded the current Atlas preview rate allowance.

Retry with backoff and keep webhook consumers idempotent.