Skip to main content
POST
/
subscriptions
/
{id}
/
resume
Resume a paused subscription
curl --request POST \
  --url https://api.cloud.flexprice.io/v1/subscriptions/{id}/resume \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "dry_run": true,
  "metadata": {},
  "resume_mode": "immediate"
}'
{
  "created_at": "<string>",
  "created_by": "<string>",
  "environment_id": "<string>",
  "id": "<string>",
  "metadata": {},
  "original_period_end": "<string>",
  "original_period_start": "<string>",
  "pause_end": "<string>",
  "pause_mode": "immediate",
  "pause_start": "<string>",
  "pause_status": "none",
  "reason": "<string>",
  "resume_mode": "immediate",
  "resumed_at": "<string>",
  "status": "published",
  "subscription_id": "<string>",
  "tenant_id": "<string>",
  "updated_at": "<string>",
  "updated_by": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Enter your API key in the format x-api-key <api-key>*

Path Parameters

​
id
string
required

Subscription ID

Body

application/json

Resume subscription request

Request object for resuming a paused subscription

​
resume_mode
enum<string>
required
Available options:
immediate,
scheduled,
auto
​
dry_run
boolean

Whether to perform a dry run @Description If true, validates the request and shows impact without actually resuming the subscription @Example false

​
metadata
object

Additional metadata as key-value pairs @Description Optional metadata for storing additional information about the resume operation @Example {"resumed_by": "admin", "reason": "issue_resolved"}

Response

OK

Response object containing subscription pause information

​
created_at
string
​
created_by
string
​
environment_id
string

EnvironmentID is the environment identifier for the pause

​
id
string

ID is the unique identifier for the subscription pause

​
metadata
object
​
original_period_end
string

OriginalPeriodEnd is the end of the billing period when the pause was created

​
original_period_start
string

OriginalPeriodStart is the start of the billing period when the pause was created

​
pause_end
string

PauseEnd is when the pause will end (null for indefinite)

​
pause_mode
enum<string>
Available options:
immediate,
scheduled,
period_end
​
pause_start
string

PauseStart is when the pause actually started

​
pause_status
enum<string>
Available options:
none,
active,
scheduled,
completed,
cancelled
​
reason
string

Reason is the reason for pausing

​
resume_mode
enum<string>
Available options:
immediate,
scheduled,
auto
​
resumed_at
string

ResumedAt is when the pause was actually ended (if manually resumed)

​
status
enum<string>
Available options:
published,
deleted,
archived
​
subscription_id
string

SubscriptionID is the identifier for the subscription

​
tenant_id
string
​
updated_at
string
​
updated_by
string
⌘I