Logout

Ends the user's session. Send at least one token so the session can be revoked.

POST /fieldservicegateway/usermanagement/v3/oauth/logout

Request

Field	Type	Required	Description
app_client_id	string	yes	Application client id
access_token	string	one token is required	Access token to revoke
refresh_token	string	one token is required	Refresh token to revoke
id_token	string	one token is required	Id token. Also used to build a browser logout address
post_logout_redirect_uri	string	no	Where the browser should go after logout

Example

{
  "app_client_id": "app-client",
  "refresh_token": "refresh-token",
  "id_token": "id-token",
  "post_logout_redirect_uri": "https://example.com/signed-out"
}

cURL

curl --request POST 'https://[BASE_URL]/fieldservicegateway/usermanagement/v3/oauth/logout' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: {{x-api-key}}' \
  --header 'Authorization: {{Authorization}}' \
  --header 'Asurion-correlationid: correlation-id' \
  --header 'Asurion-enduser: end-user' \
  --header 'Asurion-sourcesystem: source-system' \
  --header 'Asurion-serviceprovider: company-id' \
  --header 'Asurion-client: default' \
  --data '{
    "app_client_id": "app-client",
    "refresh_token": "refresh-token",
    "id_token": "id-token",
    "post_logout_redirect_uri": "https://example.com/signed-out"
  }'

Response

200 OK

logout_url is present when an id token was sent. Open it in the browser to finish logout.

{
  "success": true,
  "data": {
    "logout_url": "https://example.com/oauth/logout"
  }
}

Errors

Status	Code	When
400	VALIDATION_ERROR	app_client_id is missing, or no token was sent
500	INTERNAL_ERROR	Something unexpected failed

{
  "success": false,
  "error": "At least one of refresh_token, access_token, or id_token is required",
  "code": "VALIDATION_ERROR",
  "details": {
    "fields": [
      {
        "field": "tokens",
        "message": "At least one of refresh_token, access_token, or id_token is required",
        "code": "REQUIRED_FIELD"
      }
    ]
  },
  "correlationId": "correlation-id",
  "timestamp": "2026-10-16T00:00:00.000Z"
}