Activate a subscription

POST

subscriptions

{id}

activate

curl --request POST \
  --url https://api.alguna.io/subscriptions/{id}/activate \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

{
  "detail": "<string>",
  "status": 123
}

Authorizations

Authorization

string

header

required

API key authentication. Pass your API key as a Bearer token.

Headers

Alguna-Version

enum<string>

required

Available options:

2026-04-01

Idempotency-Key

string

A unique string used to ensure the request is processed exactly once. If you retry a request with the same idempotency key within 24 hours, the original response is returned without re-executing the operation.

Maximum string length: 255

Example:

"ik_a1b2c3d4e5f6"

Path Parameters

string

required

Unique identifier for the subscription

Response

Bad Request

detail

string

required

status

integer<int64>

required

Get valid billing dates for a subscriptionReturns the current billing cycle range, the list of valid dates for on-cycle version starts, the valid date range for mid-cycle changes, the contract end date, and the next renewal date. Use this to drive date pickers in UI flows that schedule future changes.

⌘I

Activate a subscription

curl --request POST \
  --url https://api.alguna.io/subscriptions/{id}/activate \
  --header 'Alguna-Version: <alguna-version>' \
  --header 'Authorization: Bearer <token>'

{
  "detail": "<string>",
  "status": 123
}