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_•••'

Extend Subscription Bot Memberships

Set a future end date for one membership, a selected batch, or all memberships in your Telegram or Discord subscription bot project. extend is a target date, not a duration.

Restricted keys can extend selected membership_ids. Whole-project updates with all_memberships: true require an unrestricted project API key.

Choose exactly one selector: membership_ids or all_memberships: true. Sending neither selector, or both, returns 422.

PATCH/v2/projects/{project_id}/memberships/extend

Authorization

Bearer API KeyRequired

API key scope: memberships:update (required for restricted keys).

Path Parameters

project_idstringrequired

The unique identifier of the project.

Request Body

extendstring | numberrequired

Future target expiry in UTC ISO format YYYY-MM-DDTHH:mm:ss.sssZ, for example 2030-01-01T00:00:00.000Z. Also accepts 13-digit Unix milliseconds for compatibility.

membership_idsstring[]

One to 100 distinct membership UUIDs. Use a one-item array to extend a particular membership.

all_membershipsboolean

Must be true when selecting the whole project. Cannot be combined with membership_ids.

Selection and subscription limits

For membership_ids, every membership must exist in this project, have no pending termination, and end on or before the target. Reactivating expired access must fit the plan's subscriber limit. A failure returns 404 or 409 without changing the selection.

For all_memberships: true, later end dates, lifetime memberships, and expired memberships whose plans are full are skipped. More than 10,000 memberships returns 409 without changes. The response message reports skipped memberships.

End dates never move earlier, and lifetime memberships are never given an expiration. Sending the same target again succeeds without extending access twice. Find IDs through the membership list API. To update a user's memberships together, use the user membership extension route.

To extend a membership granted through Redeem for Member, put its returned membership_id in a one-item membership_ids array.

Whole-project body:

{ "extend": "2027-12-31T23:59:59.000Z", "all_memberships": true }

curl -X PATCH "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/memberships/extend" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "membership_ids": ["6f9619ff-8b86-4011-b42d-00cf4fc964ff"],
    "extend": "2027-12-31T23:59:59.000Z"
  }'

const project_id = 'YOUR_PROJECT_ID';
 
const extend = '2027-12-31T23:59:59.000Z';
 
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/memberships/extend`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ extend, membership_ids: ['6f9619ff-8b86-4011-b42d-00cf4fc964ff'] })
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
 
extend = '2027-12-31T23:59:59.000Z'
 
response = requests.patch(
    f'https://api.botsubscription.com/v2/projects/{project_id}/memberships/extend',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={'extend': extend, 'membership_ids': ['6f9619ff-8b86-4011-b42d-00cf4fc964ff']}
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
 
$extend = '2027-12-31T23:59:59.000Z';
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/memberships/extend");
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([
    'extend' => $extend,
    'membership_ids' => ['6f9619ff-8b86-4011-b42d-00cf4fc964ff']
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Memberships extendedapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/memberships/extend",
  "code": 200,
  "total": 1,
  "message": "Membership end dates set successfully",
  "data": {
    "new_end_date": "2027-12-31T23:59:59.000Z"
  }
}

Past timestampapplication/json

{
  "ok": false,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/memberships/extend",
  "code": 422,
  "error": {
    "error_code": "VALIDATION_ERROR",
    "message": "extend must be a future timestamp"
  }
}

Membership selection is requiredapplication/json

{
  "ok": false,
  "request_id": "44444444-4444-4444-8444-444444444444",
  "method": "PATCH",
  "path": "/v2/projects/11111111-1111-4111-8111-111111111111/memberships/extend",
  "code": 422,
  "errors": [
    {
      "message": "body: Provide exactly one of membership_ids or all_memberships: true",
      "error_code": "VALIDATION_ERROR"
    }
  ]
}

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/memberships/extend",
  "code": 401,
  "error": {
    "message": "Invalid or expired authentication token.",
    "error_code": "UNAUTHORIZED"
  }
}

Last updated: November 4, 2026