Update Project Plan

Update an existing subscription plan for a project.

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 15, 2026

API Endpoint

Update Project Plan

Authorization

Path Parameters

Request Body