oauth2.dev

temporarily_unavailable

IETF

Registry Context

Use this error value when the authorization server cannot complete the request because it is temporarily overloaded or under maintenance.

Technical Summary

`temporarily_unavailable` is one of the registered OAuth 2.0 `error` values used in authorization error responses. It is carried as a single ASCII error code, and its value must satisfy the RFC6749 character restrictions for the `error` parameter.

When Used

In authorization error responses, including authorization code and implicit grant flows, when the server is temporarily unable to handle the request.

Normative Requirements

Authorization servers

MUST NOT
1
  1. RFC 6749 - Section 4.1.2.1

    emit `error` parameter values containing characters outside the permitted ASCII set..

    Condition: When serializing the `error` parameter for an OAuth 2.0 error response.

    Values for the "error" parameter MUST NOT include characters

REQUIRED
1
  1. RFC 6749 - Section 4.1.2.1

    include `temporarily_unavailable` as a valid single ASCII `error` code in authorization error responses..

    Condition: When generating an authorization error response.

    temporarily_unavailable The authorization server is currently unable to handle the request

Validation Guidance

error

Accept the registry value only if it is exactly `temporarily_unavailable`.

error

Reject any `error` value that contains characters outside the RFC6749 permitted ASCII range.

Security Notes

RFC 6749 - Section 4.1.2.1

This error indicates temporary server incapacity, so implementations should avoid exposing internal operational detail beyond the standardized code and optional response fields.

Reference

Details

Entry Id
temporarily_unavailable
Name
temporarily_unavailable
Usage Location
authorization endpoint
Protocol Extension
OAuth 2.0 Authorization Framework
Change Controller
IETF
Reference
RFC6749