Where to find the documentation about error responses from token refresh API #27007

PauloKoglin · 2024-02-13T20:16:21Z

PauloKoglin
Feb 13, 2024

Hi 👋

Is there any documentation, which lists the possible http error responses when calling an endpoint like openid-connect/token?

I'm trying to handle token errors, but I can't find the documentation, which explains why (use case) the error occurs.

Example:
When /realms/<my-client>/protocol/openid-connect/token gets called with some invalid state, I get errors like these, but I can't figure it out why:

{
  "headers":{
    "normalizedNames":{ },
    "lazyUpdate":null
  },
  "status":400,
  "statusText":"Bad Request",
  "url":"http://localhost:8080/realms/my-project/protocol/openid-connect/token",
  "ok":false,
  "name":"HttpErrorResponse",
  "message":"Http failure response for http://localhost:8080/realms/my-project/protocol/openid-connect/token: 400 Bad Request",
  "error":{
    "error":"invalid_grant",
    "error_description":"Token is not active"
  }
}

or

{
  "headers":{
    "normalizedNames":{ },
    "lazyUpdate":null
  },
  "status":400,
  "statusText":"Bad Request",
  "url":"http://localhost:8080/realms/my-project/protocol/openid-connect/token",
  "ok":false,
  "name":"HttpErrorResponse",
  "message":"Http failure response for http://localhost:8080/realms/my-project/protocol/openid-connect/token: 400 Bad Request",
  "error":{
    "error":"invalid_grant",
    "error_description":"Stale token"
  }
}

or just

"Token has expired"

I wish there was a table of error responses from endpoints :)
Any idea where to find it, if it exists?

shawkins · 2025-03-21T15:17:05Z

shawkins
Mar 21, 2025
Collaborator

Relates to #37961 - some additional logging or docs could help self-service token problems.

0 replies

Navigation Menu

Repository navigation

Where to find the documentation about error responses from token refresh API #27007

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Where to find the documentation about error responses from token refresh API #27007

Uh oh!

PauloKoglin Feb 13, 2024

Replies: 1 comment

Uh oh!

shawkins Mar 21, 2025 Collaborator

PauloKoglin
Feb 13, 2024

shawkins
Mar 21, 2025
Collaborator