---
title: Token revocation
framework: "Account & Organizational Data Sharing"
role: symbol
role_heading: Web Endpoint
platforms: [accountorganizationaldatasharing 1.0+]
path: accountorganizationaldatasharing/revoke-tokens
---

# Token revocation

Invalidate the tokens and associated user authorizations for someone when they are no longer associated with your app.

## URL

POST https://appleid.apple.com/auth/oauth2/v2/revoke

## Response Codes

200 OK: The request was successful; the provided token has been revoked successfully or was previously invalid. 400 Bad Request: The server was unable to process the request. See the error code description for more information about the underlying error.

## Overview

Overview To revoke authorization for a user, you must obtain a valid refresh token or access token. If you don’t have either token for the user, you can generate tokens when validating an authorization code. For more information about user tokens and creating client secrets, see Generate and validate tokens. To invalidate a user’s refresh token, invoke the revoke endpoint with the following HTTP POST method: curl -v POST "https://appleid.apple.com/auth/oauth2/v2/revoke" \ -H 'content-type: application/x-www-form-urlencoded' \ -d 'client_id=CLIENT_ID' \ -d 'client_secret=CLIENT_SECRET' \ -d 'token=REFRESH_TOKEN' \ -d 'token_type_hint=refresh_token' Additionally, to invalidate a user’s access token, use the following HTTP POST method: curl -v POST "https://appleid.apple.com/auth/oauth2/v2/revoke" \ -H 'content-type: application/x-www-form-urlencoded' \ -d 'client_id=CLIENT_ID' \ -d 'client_secret=CLIENT_SECRET' \ -d 'token=ACCESS_TOKEN' \ -d 'token_type_hint=access_token' For either token revocation request, the revoke endpoint returns a 200 response code without a response body after the server invalidates the token value, or if the token was previously invalidated. If the server encounters an error, it returns an ErrorResponse that identifies the problem.

## HTTP Body

The list of input parameters required for the server to invalidate the token.

## See Also

### Using and revoking tokens

- [Request an authorization](accountorganizationaldatasharing/request-an-authorization.md)
