Skip to main content
PUT
/
billing
/
subscription
/
topup
Update topup
curl --request PUT \
  --url https://api.getcargo.io/v1/billing/subscription/topup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "threshold": 123,
  "creditsCount": 123
}
'
{
  "subscription": {
    "uuid": "<string>",
    "workspaceUuid": "<string>",
    "provider": "stripe",
    "customerOrbId": "<string>",
    "customerStripeId": "<string>",
    "subscriptionStatus": "<string>",
    "subscriptionStripeId": "<string>",
    "subscriptionAvailableCreditsCount": 123,
    "subscriptionCreditsUsedCount": 123,
    "additionalAvailableCreditsCount": 123,
    "hasCredits": true,
    "creditsOverageBehaviors": [
      {
        "unit": "billing.credits",
        "action": "deny"
      }
    ],
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "plan": "self-serve",
    "cadence": "monthly",
    "fixedPrice": 123,
    "conversionRate": 123,
    "startAt": "<string>",
    "resetAt": "<string>",
    "endAt": "<string>",
    "hasPendingChange": true,
    "futureChange": {
      "cadence": "monthly",
      "fixedPrice": 123,
      "creditsCount": 123,
      "conversionRate": 123,
      "startAt": "<string>",
      "endAt": "<string>"
    },
    "topup": {
      "creditsCount": 123,
      "threshold": 123
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body schema.

enabled
boolean
required

Whether top-ups are enabled.

threshold
number
required

Credit threshold that triggers a top-up.

creditsCount
number
required

Number of credits to top up.

Response

Successful response

subscription
Subscription · object
required

Updated subscription details.