Reference

Errors.

All errors follow the same envelope. Always read the type field, not just the HTTP status.

Envelope

{
  "error": {
    "type": "forbidden",
    "message": "You do not have access to wind farm wf_xyz.",
    "requestId": "req_8f12",
    "details": []
  }
}

HTTP status codes

Status	Type	When
400	invalid_request	The request is malformed or fails validation.
401	unauthorized	Missing or invalid access token.
403	forbidden	Token does not grant access to this asset or scope.
404	not_found	The resource does not exist or is hidden from this tenant.
409	conflict	State conflict, for example a duplicate external id.
422	validation_error	Field level validation failed. See details.
429	rate_limited	Too many requests, see Retry-After header.
500	server_error	Unexpected server side error. Retry with backoff.