Skip to main content
POST
/
subscriptions
/
{subscriptionId}
/
update
/
Update a subscription
curl --request POST \
  --url https://api.kelviq.com/api/v1/subscriptions/{subscriptionId}/update/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "planIdentifier": "new_plan_enterprise",
  "chargePeriod": "YEARLY",
  "features": [
    {
      "identifier": "seats",
      "quantity": 10
    }
  ],
  "ipAddress": "103.154.35.20",
  "trialEnd": "2025-12-31 23:59:59"
}
'
{
  "subscriptionId": "dffaf07e-4517-47db-ba3a-59a05aa2d465"
}

Authorizations

​
Authorization
string
header
required

The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer YOUR_API_KEY'

Path Parameters

​
subscriptionId
string<uuid>
required

The unique identifier of the subscription to be updated. Example UUID from docs: 78058918-9746-4280-9b9b-1bd5115eec6e

Body

application/json
​
planIdentifier
string
required

The identifier of the new plan.

Example:

"new_plan_enterprise"

​
chargePeriod
enum<string>
required

The new charging period for the subscription.

Available options:
ONE_TIME,
MONTHLY,
YEARLY,
WEEKLY,
DAILY,
THREE_MONTHS,
SIX_MONTHS
Example:

"YEARLY"

​
features
object[] | null

List of features and quantities to update for the subscription.

Example:
[{ "identifier": "seats", "quantity": 10 }]
​
ipAddress
string | null

The IP Address of the customer, for location-based pricing.

Example:

"103.154.35.20"

​
trialEnd
string | null

Controls the trial period for the updated subscription. Accepts either the literal string "now" to end any active trial immediately, or an ISO 8601 datetime string (e.g. "2025-05-22 08:27:45.430732") to set a new trial end date. The datetime must be in the future. If omitted, the existing trial behavior is preserved.

Example:

"2025-12-31 23:59:59"

Response

200 - application/json

UUID of the updated subscription

​
subscriptionId
string
Example:

"dffaf07e-4517-47db-ba3a-59a05aa2d465"