Skip to content

An AI client revoking its token, as it disconnects: its grant ends (RFC 7009). Any token answers 200

POST
/oauth/revoke
curl --request POST \
--url https://example.com/oauth/revoke \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data client_id=example \
--data token=example \
--data token_type_hint=example

Who: anyone.

Media typeapplication/x-www-form-urlencoded
object
client_id
required
string
token
required
string
token_type_hint
string

Example generated

client_id=example&token=example&token_type_hint=example

OK

Media typeapplication/json
object

Example generated

{}

A request OAuth refuses, in OAuth’s words

Media typeapplication/json
object
error
required
string
error_description
required
string

Example generated

{
"error": "example",
"error_description": "example"
}

An error, as go-commons apperr maps it

Media typeapplication/json
object
error
required
object
code
required
string
fields
object
key
additional properties
string
message
required
string

Example generated

{
"error": {
"code": "example",
"fields": {
"additionalProperty": "example"
},
"message": "example"
}
}