Errors

Errors use one stable envelope across REST endpoints. Never parse human-readable text to identify an error; branch on the machine-readable code and HTTP status.

{"error":{"code":"invalid_request","message":"name and provider are required."}}

• 400 invalid_request or validation failure
• 401 unauthorized for missing or invalid keys
• 404 not_found for missing resources
• 429 rate_limit_exceeded; honor Retry-After
• 500 configuration_error or server failure