Resume Subscription
Resume a paused subscription, immediately or on a specific future date.
Resume timing (public API calls only, via the optional request body):
- immediately (default): Clears pause fields and transitions the subscription back to TRIALING (if trial hasn’t expired) or ACTIVE.
- on_date: Keeps the subscription PAUSED and (re)schedules an automatic
resume for
resume_date. Use this to set a future resume date on an already-paused subscription, or to update an existing scheduled date. The lifecycle auto-resumes the subscription when that date arrives. Returns the still-paused SubscriptionResponse (with resumes_at set).
Emits subscription.resumed (immediate) or subscription.resume_scheduled
(on_date) webhook event.
When from_workflow=true (Restate calls): resumes immediately and returns
ResumeSubscriptionResponse with a status field. Skips (“skipped”) when the
subscription is not paused (not_paused), when it is paused indefinitely with
no scheduled resume (no_scheduled_resume — any timer firing against it is by
definition stale), or when resumes_at is not yet due (not_yet_due — the
timer belongs to an earlier, superseded schedule; resuming early would bill the
customer sooner than they agreed). The request body is ignored for workflow
calls. Public API calls (from_workflow=false) are not timers and skip none of
the due checks.
When from_workflow=false (public API calls): returns SubscriptionResponse.
Works for User, API Key, and Restate workflow authentication. Account access is automatically validated via endpoint dependency.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
Query parameters
Request
When to resume the subscription (immediately or on a specific date)
Specific datetime for auto-resume. Required when resume_timing is 'on_date'.