Update Project Plan - Modify Subscription Settings via API

Modify an existing subscription plan's settings. Change the name, adjust pricing, update the billing cycle, or toggle payment options. Only the fields you include in the request body are updated—all other settings remain unchanged.

PATCH/v2/projects/{project_id}/plans/{plan_id}

Authorization

Bearer TokenRequired

Path Parameters

project_idstringRequired

The unique identifier of the project.

plan_idstringRequired

The unique identifier of the plan to update.

Request Body

plan_namestring

Display name of the plan.

plan_pricestring

Price amount for the plan as a string.

plan_currencystring

Three-letter currency code (e.g., USD, EUR).

plan_durationstring

Duration of the plan (e.g., '1 hour', '1 day', '1 month').

plan_price_formattedstring

Formatted price display string (e.g., '$10.00').

plan_dataobject

Additional plan configuration options.

plan_data.plan_recurringboolean

Whether the plan supports recurring payments.

plan_data.plan_one_timeboolean

Whether the plan supports one-time payments.

All fields are optional. Only provided fields will be updated.

Request

curl -X PATCH "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/plans/YOUR_PLAN_ID" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_name": "Pro Plan (Updated)",
    "plan_price": "34.99",
    "plan_price_formatted": "$34.99"
  }'

const project_id = 'YOUR_PROJECT_ID';
const plan_id = 'YOUR_PLAN_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/plans/${plan_id}`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    plan_name: 'Pro Plan (Updated)',
    plan_price: '34.99',
    plan_price_formatted: '$34.99'
  })
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
plan_id = 'YOUR_PLAN_ID'
response = requests.patch(
    f'https://api.botsubscription.com/v2/projects/{project_id}/plans/{plan_id}',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
    json={
        'plan_name': 'Pro Plan (Updated)',
        'plan_price': '34.99',
        'plan_price_formatted': '$34.99'
    }
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
$plan_id = 'YOUR_PLAN_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/plans/{$plan_id}");
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([
    'plan_name' => 'Pro Plan (Updated)',
    'plan_price' => '34.99',
    'plan_price_formatted' => '$34.99'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Plan updatedapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/YOUR_PROJECT_ID/plans/YOUR_PLAN_ID",
  "code": 200,
  "message": "Plan updated successfully",
  "data": {
    "plan_name": "Pro Plan (Updated)",
    "plan_price": "34.99",
    "plan_currency": "USD",
    "plan_duration": "1 month",
    "plan_price_formatted": "$34.99",
    "plan_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "plan_data": {
      "plan_recurring": false,
      "plan_one_time": true
    },
    "plan_targets": []
  }
}

Last updated: January 25, 2026

API Endpoint

Update Project Plan - Modify Subscription Settings via API

Authorization

Path Parameters

Request Body