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 TokenRequired

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.

Request

curl -X PATCH "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/targets" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -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_TOKEN',
    '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_TOKEN',
        '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_TOKEN',
    '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/YOUR_PROJECT_ID/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
    },
    {
      "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
    }
  ]
}

Invalid requestapplication/json

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

Last updated: January 25, 2026

API Endpoint

Update Multiple Targets

Authorization

Path Parameters

Request Body