unpause_subscription

Resume a paused subscription — billing restarts and resource access is restored. Refuses anything that is not paused.

Purpose

The reverse of pause_subscription: billing restarts on the plan's schedule and the member's access to the plan's resources is restored, with fresh invite links where they are needed. Safe to call — it restores service rather than removing it.

Refuses a subscription that is not currently paused, so it cannot be used to revive a cancelled or expired one; that is reactivate_subscription for a scheduled cancellation, or a new purchase. Emits subscription.unpaused.

Required ability

project-subscription:update

Input schema

{
  "type": "object",
  "required": ["subscription_id"],
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "UUID of the subscription to act on."
    }
  }
}

Output shape

{
  "data": {
    "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
    "plan_id": "9b7c2e15-4d63-4f80-a2b1-7e5d0c9f3a46",
    "payment_status": "active",
    "outcome": "active"
  }
}

Example prompts

"Resume subscription 5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4 — the member is back."

"Unfreeze Ada's Premium subscription."

"Take this member off hold and restart their billing."

Failure modes

VALIDATION_FAILED — the subscription is not paused.
RESOURCE_NOT_FOUND — unknown subscription_id, or a subscription outside the token's scope.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks project-subscription:update.

pause_subscription — the reverse.
reactivate_subscription — for a cancellation that was scheduled by mistake.
Subscriptions API — the REST equivalent.