{% extends "_layout.html" %} {% set title = "Upgrade required" %} {% set status = "426 Upgrade Required" %} {% set description = "A credential was offered over plaintext. Re-send over https." %} {% block main %}
A credential — an access token, a refresh token, a device_code or a user_code — was sent over plaintext to a deployment that authenticates.
https.https address. A client never downgrades.{
"type": "https://sc.example.com/server-errors/insecure-transport",
"title": "Upgrade required",
"status": 426,
"detail": "...",
"instance": "/v1/jobs/01J9...",
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
detail is prose and may be reworded at any time. Branch on type — never parse detail.
| any endpoint that takes a credential | Including the token endpoint and the device-login approval leg. |
Raised at POST /v1/auth/token and POST /v1/auth/device too, before any
OAuth processing, and in problem+json there as everywhere — never as an OAuth
error. A client handles it by its status and type.
invalid-token is a token that arrived safely and was not accepted.