{% 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.

What to do

  1. Re-send over https.
  2. Point your client at the server’s https address. A client never downgrades.

The body

{
  "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.

Where it comes from

any endpoint that takes a credential Including the token endpoint and the device-login approval leg.
{% include "_help.html" %}

At the two OAuth endpoints

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.

What this is not

invalid-token is a token that arrived safely and was not accepted.

{% endblock %}