Editing SimTX API v24/Account service (section)

== Errors ==
Every error response has the same JSON body:

<syntaxhighlight lang="json">
{
  "code": "credential_invalid",
  "message": "The access credential is invalid or expired",
  "fieldErrors": {},
  "requestId": "3d7f0c1e-5b2a-4a8e-9a77-1f0f6f5d2b10"
}
</syntaxhighlight>

{| class="wikitable"
! Field !! Type !! Description
|-
| <code>code</code> || string || Stable, machine-readable error code. Branch on this.
|-
| <code>message</code> || string || Human-readable English text. May change; do not parse.
|-
| <code>fieldErrors</code> || object || Additional string values keyed by name. For example, device polling reports the required poll interval as <code>fieldErrors.interval</code>.
|-
| <code>requestId</code> || string || The request ID. See [[#Conventions|Conventions]].
|}

=== Common error codes ===
{| class="wikitable"
! HTTP !! <code>code</code> !! Meaning
|-
| 401 || <code>credential_missing</code> || No <code>Authorization</code> header, or it does not start with <code>Bearer </code>.
|-
| 401 || <code>credential_invalid</code> || The bearer credential is unknown, expired, revoked, or belongs to an account that is not active. Refresh once and retry; if that fails, sign in again.
|-
| 400 || <code>scope_invalid</code> || A requested scope is not a known [[SimTX API v24/Permissions|permission]].
|-
| 400 || <code>ticket_request_invalid</code> || See [[SimTX API v24/Game tickets#Errors|Game tickets]].
|-
| 400 || <code>authorization_pending</code>, <code>slow_down</code>, <code>expired_token</code>, <code>access_denied</code>, <code>invalid_grant</code> || Device polling states. See [[SimTX API v24/Device login#Polling for credentials|Device login]].
|-
| 401 || <code>invalid_grant</code>, <code>refresh_reuse_detected</code> || Refresh failures. See [[SimTX API v24/Device login#Refreshing|Device login]].
|-
| 404 || <code>profile_not_found</code>, <code>release_artifact_not_found</code>, <code>release_manifest_unavailable</code> || The requested public resource does not exist.
|-
| 429 || <code>rate_limited</code> || A rate-limit bucket is exhausted. See below.
|-
| 500 || <code>internal_error</code> || Unexpected server failure. Retry later with backoff.
|}