Revoke API Key - Disable Integration Access Immediately

Permanently disable an API key to block all requests using it. Revocation takes effect immediately and cannot be undone. Use this when rotating credentials, responding to security incidents, or decommissioning integrations that no longer need access.

DELETE/v2/projects/{project_id}/integrations/api-keys/{key_id}

Authorization

Bearer TokenRequired

Path Parameters

project_idstringRequired

The unique identifier of the project.

key_idstringRequired

The unique identifier of the API key to revoke.

Request

curl -X DELETE "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/integrations/api-keys/API_KEY_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

const project_id = 'YOUR_PROJECT_ID';
const key_id = 'API_KEY_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/integrations/api-keys/${key_id}`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});

import requests
 
project_id = 'YOUR_PROJECT_ID'
key_id = 'API_KEY_ID'
response = requests.delete(
    f'https://api.botsubscription.com/v2/projects/{project_id}/integrations/api-keys/{key_id}',
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)

$project_id = 'YOUR_PROJECT_ID';
$key_id = 'API_KEY_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/integrations/api-keys/{$key_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);

API key revokedapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "DELETE",
  "path": "/v2/projects/YOUR_PROJECT_ID/integrations/api-keys/API_KEY_ID",
  "code": 200,
  "message": "API key revoked successfully",
  "data": {
    "id": "22222222-2222-2222-2222-222222222222",
    "label": "staging bot",
    "last_four": "1d9e",
    "created_at": "2025-02-10T09:30:12.000Z",
    "created_by": null,
    "updated_at": "2025-02-10T09:30:12.000Z",
    "updated_by": null,
    "revoked_at": "2025-02-12T09:00:00.000Z",
    "revoked_by": null
  }
}

Last updated: January 25, 2026

API Endpoint

Revoke API Key - Disable Integration Access Immediately

Authorization

Path Parameters