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

Headers0

BodyJSON

Examples

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

Update Multiple Targets

Modify several access destinations in a single API call. Pass an array of target updates to enable or disable multiple Discord roles or Telegram channels at once. This is efficient for bulk operations like temporarily disabling access during maintenance.

PATCH/v2/projects/{project_id}/targets

Authorization

Bearer API KeyRequired

API key access: Unrestricted project API key required. Restricted keys cannot call this endpoint.

Path Parameters

project_idstringrequired

The unique identifier of the project.

Request Body

The request body should be an array of objects, each containing:

target_idstringrequired

The internal target ID (UUID) to update.

is_enabledboolean

Whether the target is enabled.

target_namestring

Display name for the target.

The success response contains total, a message, and an array of updated targets in data. The optional metadata below applies to each target.

Response Metadata

parent_target_idstring | null

Optional parent target UUID; null when there is no parent.

participant_countinteger

Optional nonnegative participant count.

originstring

Optional target origin: manual or auto-discovered.

discovered_atstring | null

Optional discovery time as a UTC ISO 8601 timestamp, or null when no discovery time is recorded.

curl -X PATCH "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/targets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "target_id": "11111111-1111-1111-1111-111111111111",
      "is_enabled": true
    },
    {
      "target_id": "22222222-2222-2222-2222-222222222222",
      "is_enabled": false
    }
  ]'

const project_id = 'YOUR_PROJECT_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/targets`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify([
    {
      target_id: '11111111-1111-1111-1111-111111111111',
      is_enabled: true
    },
    {
      target_id: '22222222-2222-2222-2222-222222222222',
      is_enabled: false
    }
  ])
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
response = requests.patch(
    f'https://api.botsubscription.com/v2/projects/{project_id}/targets',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=[
        {
            'target_id': '11111111-1111-1111-1111-111111111111',
            'is_enabled': True
        },
        {
            'target_id': '22222222-2222-2222-2222-222222222222',
            'is_enabled': False
        }
    ]
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/targets");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    [
        'target_id' => '11111111-1111-1111-1111-111111111111',
        'is_enabled' => true
    ],
    [
        'target_id' => '22222222-2222-2222-2222-222222222222',
        'is_enabled' => false
    ]
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Targets updatedapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/targets",
  "code": 200,
  "total": 2,
  "message": "Successfully updated 2 target(s)",
  "data": [
    {
      "target_id": "11111111-1111-1111-1111-111111111111",
      "target_name": "Premium Members",
      "platform": "discord",
      "kind": "role",
      "external_id": "123456789012345678",
      "is_enabled": true,
      "plan_count": 3,
      "parent_target_id": "33333333-3333-3333-3333-333333333333",
      "participant_count": 150,
      "origin": "manual",
      "discovered_at": null
    },
    {
      "target_id": "22222222-2222-2222-2222-222222222222",
      "target_name": "VIP Channel",
      "platform": "telegram",
      "kind": "channel",
      "external_id": "-1001234567890",
      "is_enabled": false,
      "plan_count": 1,
      "parent_target_id": null,
      "participant_count": 45,
      "origin": "manual",
      "discovered_at": null
    }
  ]
}

Invalid requestapplication/json

{
  "ok": false,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/targets",
  "code": 400,
  "error": {
    "error_code": "BAD_REQUEST",
    "message": "Request body must be an array of target updates"
  }
}

Invalid or expired API keyapplication/json

{
  "ok": false,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/targets",
  "code": 401,
  "error": {
    "message": "Invalid or expired authentication token.",
    "error_code": "UNAUTHORIZED"
  }
}

Last updated: November 4, 2026