> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Een MCP OAuth-verbinding intrekken
> Trek een verbinding in met een van de toegangs- of vernieuwingstokens ervan en de geregistreerde client_id.
Trek een verbinding in met een van de toegangs- of vernieuwingstokens ervan en de geregistreerde client\_id.
```http theme={null}
POST https://api.voicecheap.ai/oauth/revoke
```
## Authenticatie
Geen clientgeheim. Stuur token en client\_id in de URL-gecodeerde formulierbody.
## Aanvraagbody
Een uitgegeven MCP-toegangstoken of vernieuwingstoken. Onbekende tokentekenreeksen worden geaccepteerd zonder te onthullen of een token bestaat.
Minimale lengte: 1. Maximale lengte: 256. Patroon: `^[^\u0000-\u001F\u007F]+$`.
De client\_id die bij het token hoort. Een ontbrekende scalaire waarde of een scalaire waarde met een ongeldige indeling wordt geweigerd; een onbekende of niet-overeenkomende client retourneert een geslaagd antwoord.
Minimale lengte: 1. Maximale lengte: 2048. Patroon: `^[^\u0000-\u001F\u007F]+$`.
Optionele standaardhint. Deze implementatie negeert dit veld en valideert de waarde niet; tokenprefixen bepalen de tokenfamilie.
```json theme={null}
{
"type": "object",
"properties": {
"token": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"pattern": "^[^\\u0000-\\u001F\\u007F]+$",
"description": "An issued MCP access or refresh token. Unknown token strings are accepted without revealing whether a token exists."
},
"client_id": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"pattern": "^[^\\u0000-\\u001F\\u007F]+$",
"description": "The client_id associated with the token. A missing or malformed scalar is rejected; an unknown or mismatched client returns success."
},
"token_type_hint": {
"description": "Optional standard hint. This implementation ignores this field and does not validate its value; token prefixes determine the token family."
}
},
"required": [
"token",
"client_id"
],
"additionalProperties": true
}
```
## Voorbeeldaanvragen
Volg de gedocumenteerde codering en authenticatie voor deze route. De antwoordstructuur en idempotentieregels van de actie-API gelden alleen voor actieaanroepen.
```bash cURL theme={null}
curl --request POST 'https://api.voicecheap.ai/oauth/revoke' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=mcp_refresh_EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE' \
--data-urlencode 'client_id=mcp_client_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' \
--data-urlencode 'token_type_hint=refresh_token'
```
```javascript JavaScript theme={null}
const input = {
token: 'mcp_refresh_EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE',
client_id: 'mcp_client_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
token_type_hint: 'refresh_token',
};
const response = await fetch('https://api.voicecheap.ai/oauth/revoke', {
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
},
body: new URLSearchParams(input),
redirect: 'manual',
});
console.log(response.status, await response.text());
```
```python Python theme={null}
import os
import requests
response = requests.request(
"POST",
"https://api.voicecheap.ai/oauth/revoke",
headers={"Content-Type":"application/x-www-form-urlencoded"},
data={"token": "mcp_refresh_EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE", "client_id": "mcp_client_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "token_type_hint": "refresh_token"},
timeout=120,
allow_redirects=False,
)
print(response.status_code, response.text)
```
## Antwoord
Een leeg JSON-object. Onbekende tokens, verkeerde clientkoppelingen en al ingetrokken verbindingen retourneren ook HTTP 200.
```json HTTP 200 theme={null}
{}
```
## Antwoordheaders
```json theme={null}
{
"Cache-Control": "no-store",
"Pragma": "no-cache"
}
```
## Opmerkingen bij de bewerking
* Herkende scalaire parameters moeten eenmaal worden opgegeven als niet-lege strings zonder ASCII-besturingstekens of DEL. Herhaalde query-/formuliervelden worden gedecodeerd als arrays en geweigerd wanneer ze als scalaire waarden worden gelezen.
* Gebruik application/x-www-form-urlencoded. JSON-aanvragen worden geweigerd met invalid\_request.
* Het intrekken van een herkend toegangstoken of vernieuwingstoken trekt de volledige verbinding in en wist het actieve vernieuwingstoken; dit blijft niet beperkt tot het opgegeven token.
* De parameter resource is op deze route niet verplicht en wordt niet gecontroleerd. token\_type\_hint en andere niet-herkende velden worden genegeerd.
* Het endpoint haalt niet eerst een clientregistratie op. Een onbekende client\_id met een geldige indeling, een onjuiste client\_id voor het token of een onbekend token retourneert \{} zonder de geldigheid van het token te onthullen.
* De openbare intrekkingslimiet is 60 aanvragen per minuut per client-IP, gedeeld door alle workers. URL-gecodeerde body's zijn beperkt tot 32 KiB.
* De client\_id uit dynamische registratie of de exacte openbare HTTPS-URL van het clientmetadatadocument.
## Fouten
| HTTP-status | Code | Betekenis of herstel |
| - | - | - |
| 400 | `invalid_request` | De body of een herkende parameter is ongeldig, ontbreekt, is dubbel opgegeven of heeft de verkeerde codering. |
| 413 | `REQUEST_TOO_LARGE` | De aanvraag overschrijdt de toegestane bodygrootte. JSON is beperkt tot 1 MiB en URL-gecodeerde formulieren tot 32 KiB. |
| 415 | `UNSUPPORTED_CONTENT_TYPE` | De bodyparser van de integratie accepteert alleen JSON of URL-gecodeerde formulieren. De route kan specifiek een van deze coderingen vereisen. |
| 429 | `temporarily_unavailable` | De openbare frequentielimiet voor OAuth-aanvragen is bereikt. Wacht tot het huidige tijdvenster voorbij is voordat je het opnieuw probeert. |
| 500 | `server_error` | Autorisatie is tijdelijk niet beschikbaar. Probeer het later opnieuw. |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.