Skip to content
Northwestern Laravel Starter

Revoke an access token

DELETE
/api/v1/me/tokens/{token}
 
curl --request DELETE \
  --url https://example.com/api/v1/me/tokens/42 \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
token
required
integer format: int64
Example 
42

The ID of the access token to revoke.

Responses

Section titled “ Responses ”

204

Section titled “204 ”

Access token revoked.

401

Section titled “401 ”

Missing or invalid bearer token.

Media type application/json

Standard RFC 9457 problem details envelope.

object
type
required

RFC 9457 compliant problem details response builder.

string format: uri
title
required
string
status
required
integer
detail
string
nullable
instance
required
string format: uri-reference
trace_id

Unique identifier for the API request (if available).

string
nullable
Example 
{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication failed",
  "instance": "/api/v1/me",
  "trace_id": "b4f5aa7a-1470-4d92-8d3c-98e7c7de9f5f"
}

404

Section titled “404 ”

Access token not found.

Media type application/json

Standard RFC 9457 problem details envelope.

object
type
required

RFC 9457 compliant problem details response builder.

string format: uri
title
required
string
status
required
integer
detail
string
nullable
instance
required
string format: uri-reference
trace_id

Unique identifier for the API request (if available).

string
nullable
Example 
{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication failed",
  "instance": "/api/v1/me",
  "trace_id": "b4f5aa7a-1470-4d92-8d3c-98e7c7de9f5f"
}

422

Section titled “422 ”

Cannot revoke the token currently being used.

Media type application/json

Standard RFC 9457 problem details envelope.

object
type
required

RFC 9457 compliant problem details response builder.

string format: uri
title
required
string
status
required
integer
detail
string
nullable
instance
required
string format: uri-reference
trace_id

Unique identifier for the API request (if available).

string
nullable
Example 
{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication failed",
  "instance": "/api/v1/me",
  "trace_id": "b4f5aa7a-1470-4d92-8d3c-98e7c7de9f5f"
}