Skip to main content
PUT
/
subscriptions
/
{subscription_id}
/
pause
Update a subscription pause
curl --request PUT \
  --url https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/pause \
  --header 'Content-Type: application/json' \
  --header 'X-SALESBRICKS-KEY: <api-key>' \
  --data '
{
  "paused_at": "2023-11-07T05:31:56Z",
  "scheduled_resume_at": "2023-11-07T05:31:56Z",
  "pause_reason": "<string>"
}
'
{
  "subscription_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pause_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "paused_at": "2023-11-07T05:31:56Z",
  "scheduled_resume_at": "2023-11-07T05:31:56Z",
  "resumed_at": "2023-11-07T05:31:56Z",
  "extension_days": 123,
  "is_active": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.salesbricks.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-SALESBRICKS-KEY
string
header
required

API key for authentication

Path Parameters

​
subscription_id
string
required
Pattern: ^([a-zA-Z\d\-]+)$

Body

Input serializer for updating a subscription pause (upcoming or active).

For upcoming pauses: Can update paused_at, scheduled_resume_at, pause_reason For active pauses: Can only update scheduled_resume_at, pause_reason

​
paused_at
string<date-time> | null

New pause start date (ISO 8601 datetime). Only allowed for upcoming pauses, not active pauses.

​
scheduled_resume_at
string<date-time> | null

New scheduled resume date (ISO 8601 datetime).

​
pause_reason
string | null

New reason for the pause.

Response

Output serializer for pause subscription response.

​
subscription_id
string<uuid>
required

ID of the subscription.

​
pause_id
string<uuid>
required

ID of the pause record.

​
paused_at
string<date-time>
required

When the pause started.

​
scheduled_resume_at
string<date-time> | null
required

When the subscription is scheduled to automatically resume (set at pause time).

​
resumed_at
string<date-time> | null
required

When the subscription was actually resumed (null if still paused).

​
extension_days
integer
required

Number of days the subscription end date was extended.

​
is_active
boolean
required

Whether the pause is currently active.