Errors

Every error uses the same format.

{
  "error": {
    "type": "permission_error",
    "code": "missing_scope",
    "message": "This credential lacks the members:write scope.",
    "param": null,
    "request_id": "req_7gyzbwb82m29yktch9sn4gn03s"
  }
}

Use code in your own logic, because message may change. If you contact us about a failed request, include the request_id. It’s also in the X-Request-Id header of every response.

Status	Meaning
400	The request is invalid. param names the field, where there is one.
401	The credentials are missing, invalid, expired or revoked.
403	The credentials are valid but not allowed to do this, for example missing_scope, scope_escalation, email_not_verified or organization_suspended.
404	The resource doesn’t exist in your organization.
409	The request conflicts with the current state, for example last_owner or key_revoked.
429	Too many attempts. Try again later.
500	Something went wrong on our side.