Revoke a refresh token (sign out)

POST

/v1/auth/revoke

const url = 'http://localhost:8080/v1/auth/revoke';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"refreshToken":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url http://localhost:8080/v1/auth/revoke \
  --header 'Content-Type: application/json' \
  --data '{ "refreshToken": "example" }'

Anonymous. Revokes the presented refresh token and records the sign-out. Idempotent: an unknown or already revoked token still answers 204.

Request Body^required

application/json

object

refreshToken

string

Example^generated

{
  "refreshToken": "example"
}

Responses

204

No Content

Revoke a refresh token (sign out)

Request Bodyrequired

Examplegenerated

Responses

204

Request Body^required

Example^generated