api.botsubscription.com

GET/v1/endpoint

AuthenticationBearer

Token

Stays in this tab. Required for this endpoint — the value below is what gets sent.

Path parameters0

Query parameters0

BodyJSON

Mock

curl --request GET \
  --url https://api.botsubscription.com/v1/endpoint \
  --header 'Authorization: Bearer sk_live_•••'

Revoke a Subscription Bot Access Token

Disable an unused access code for your Telegram subscription bot or Discord subscription bot. Revocation does not terminate a membership already granted by a code.

DELETE/v2/projects/{project_id}/access-tokens/{access_token_id}

Authorization

Bearer TokenRequired

Requires memberships:delete for a human admin. Restricted project API keys need access-tokens:revoke.

Path Parameters

project_idstringrequired

The UUID of the project.

access_token_idstringrequired

UUID of the activated access token to revoke.

Behavior and recovery

Only activated, unused tokens can be revoked. An already revoked token returns 204 again. A redeemed token or one reserved for pending billing returns 409. An unknown or unactivated token ID returns 404.

Find IDs through List Tokens. To end an existing membership, use Delete Membership.

curl -X DELETE "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/YOUR_ACCESS_TOKEN_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/YOUR_ACCESS_TOKEN_ID", {
  method: 'DELETE',
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});
// 204 No Content on success; no JSON body to parse.

import requests
 
response = requests.delete(
    "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/YOUR_ACCESS_TOKEN_ID",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    }
)
# 204 No Content on success; no JSON body to parse.

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/access-tokens/YOUR_ACCESS_TOKEN_ID');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
// 204 No Content on success; no JSON body to parse.

Token revoked or already revokedapplication/json

No response body is returned.

Token redeemed or billing pendingapplication/json

{
  "ok": false,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "DELETE",
  "path": "/v2/projects/YOUR_PROJECT_ID/access-tokens/YOUR_ACCESS_TOKEN_ID",
  "code": 409,
  "error": {
    "error_code": "CONFLICT",
    "message": "The access token cannot be revoked."
  }
}

Activated token not foundapplication/json

{
  "ok": false,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "DELETE",
  "path": "/v2/projects/YOUR_PROJECT_ID/access-tokens/YOUR_ACCESS_TOKEN_ID",
  "code": 404,
  "error": {
    "error_code": "NOT_FOUND",
    "message": "Requested resource could not be found."
  }
}

Last updated: October 19, 2026