API v1 errors - SpaPortal Docs

API v1 keeps the legacy error response shape:

{
  "success": false,
  "message": "Missing API key"
}

Read both the HTTP status and the message field.

Status codes

Status	Meaning
`400`	The request is malformed, a required parameter is missing, or validation failed.
`401`	The API key is missing or invalid.
`404`	The requested resource was not found.
`409`	The request matched more than one company.
`422`	The resource exists but cannot be used for the requested operation.
`500`	An unexpected server error occurred. Retry with backoff if the operation is safe to repeat.

Treat 400, 401, 404, and 422 as client-correctable errors. Retry only after you change the request.