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

Update Admin - Modify Team Member Permissions via API

Change the permissions assigned to an existing administrator. You can expand access by adding new permissions or restrict it by removing them. This replaces the admin's entire permission set with the new array you provide.

PUT/v2/projects/{project_id}/admins/{user_id}

Authorization

Bearer TokenRequired

Path Parameters

project_idstringrequired

The unique identifier of the project.

user_idstringrequired

The unique identifier of the admin user.

Request Body

permissionsarrayrequired

Array of permission strings to grant.

curl -X PUT "https://api.botsubscription.com/v2/projects/f47ac10b-58cc-4372-a567-0e02b2c3d479/admins/user_123456789" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "permissions": ["users:read", "users:write", "plans:read", "plans:write", "memberships:read", "memberships:write"]
  }'

const project_id = 'f47ac10b-58cc-4372-a567-0e02b2c3d479';
const user_id = 'user_123456789';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/admins/${user_id}`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    permissions: ['users:read', 'users:write', 'plans:read', 'plans:write', 'memberships:read', 'memberships:write']
  })
});
const data = await response.json();

import requests
 
project_id = 'f47ac10b-58cc-4372-a567-0e02b2c3d479'
user_id = 'user_123456789'
response = requests.put(
    f'https://api.botsubscription.com/v2/projects/{project_id}/admins/{user_id}',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'permissions': ['users:read', 'users:write', 'plans:read', 'plans:write', 'memberships:read', 'memberships:write']
    }
)
data = response.json()

$project_id = 'f47ac10b-58cc-4372-a567-0e02b2c3d479';
$user_id = 'user_123456789';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/admins/{$user_id}");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'permissions' => ['users:read', 'users:write', 'plans:read', 'plans:write', 'memberships:read', 'memberships:write']
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Admin updatedapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PUT",
  "path": "/v2/projects/YOUR_PROJECT_ID/admins/123456789012345678",
  "code": 200,
  "message": "Admin updated successfully",
  "data": {
    "user_id": "123456789012345678",
    "user_name": {
      "first_name": "John",
      "username": "john_admin"
    },
    "permissions": [
      "users:read",
      "users:update",
      "plans:read",
      "plans:add",
      "memberships:read",
      "memberships:update"
    ]
  }
}

Admin not foundapplication/json

{
  "ok": false,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PUT",
  "path": "/v2/projects/YOUR_PROJECT_ID/admins/123456789012345678",
  "code": 404,
  "error": {
    "error_code": "NOT_FOUND",
    "message": "Admin not found. Add the user as an admin before updating their permissions."
  }
}

Last updated: May 28, 2026