# Revoke Access Token

Endpoint to revoke provided access token.

The request must be formatted using the `application/x-www-form-urlencoded` media type.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Authentication",
    "version": "2.0.0",
    "description": "Collection of endpoints to support authentication."
  },
  "servers": [
    {
      "url": "https://api.personio.de"
    }
  ],
  "paths": {
    "/v2/auth/revoke": {
      "description": "The OAuth2.0 token revocation endpoint.",
      "summary": "Revoke Access Token",
      "post": {
        "tags": [
          "Authentication"
        ],
        "description": "Endpoint to revoke provided access token.\n\nThe request must be formatted using the `application/x-www-form-urlencoded` media type.\n",
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/OAuth2TokenRevocationRequest"
              },
              "examples": {
                "Success - Access Token": {
                  "$ref": "#/components/examples/OAuth2TokenRevocationSuccessRequest"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The request was successful and a empty response body returned.",
            "x-response-example": "Success - Access Token"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "OAuth2TokenRevocationRequest": {
        "description": "The request for the OAuth2.0 token revocation.",
        "type": "object",
        "properties": {
          "token": {
            "description": "The token that has to be removed.",
            "example": "papi-dcec6d81-8c0f-47f0-9dd8-4e59755f041a",
            "type": "string"
          }
        },
        "required": [
          "token"
        ]
      }
    },
    "examples": {
      "OAuth2TokenRevocationSuccessRequest": {
        "value": {
          "token": "papi-baaaaaad-c0de-fade-baad-00000000001d"
        }
      }
    }
  }
}
```