Update Multiple Settings

Change several configuration options in a single API call. Pass an object with setting keys and their new values. This is more efficient than making individual update requests when you need to modify multiple settings at once, such as during initial setup.

PATCH/v2/projects/{project_id}/settings

Authorization

Bearer TokenRequired

Path Parameters

project_idstringRequired

The unique identifier of the project.

Request Body

The request body should be an object with setting keys and their new values.

Request

curl -X PATCH "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/settings" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "default_language": "en",
    "timezone_preference": "America/New_York",
    "collect_email_on_subscribe": true
  }'

const project_id = 'YOUR_PROJECT_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/settings`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    default_language: 'en',
    timezone_preference: 'America/New_York',
    collect_email_on_subscribe: true
  })
});
// 204 No Content on success

import requests
 
project_id = 'YOUR_PROJECT_ID'
response = requests.patch(
    f'https://api.botsubscription.com/v2/projects/{project_id}/settings',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'default_language': 'en',
        'timezone_preference': 'America/New_York',
        'collect_email_on_subscribe': True
    }
)
# 204 No Content on success

$project_id = 'YOUR_PROJECT_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/settings");
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([
    'default_language' => 'en',
    'timezone_preference' => 'America/New_York',
    'collect_email_on_subscribe' => true
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
// 204 No Content on success

Settings updatedapplication/json

No response body is returned on successful update.

Invalid setting valueapplication/json

{
  "ok": false,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "PATCH",
  "path": "/v2/projects/YOUR_PROJECT_ID/settings",
  "code": 400,
  "error": {
    "error_code": "BAD_REQUEST",
    "message": "Invalid value for setting 'timezone_preference'"
  }
}

Last updated: January 25, 2026

API Endpoint

Update Multiple Settings

Authorization

Path Parameters

Request Body