CH·02CLI reference

deeprelay billing cancel

Cancel or manage your subscription (prints a Stripe billing portal link)

Synopsis

Prints a link to your Stripe billing portal — where you cancel the subscription, resume one you cancelled, change the payment method, or download invoices.

Manage your subscription here:

  https://billing.stripe.com/p/session/live_...

Cancel, resume, change payment method, or download invoices.
Cancelling keeps your plan active until the end of the current period.

The command is named cancel because that is what people come looking for, but the portal covers the whole lifecycle. That matters in the common case where a subscription is about to lapse over a declined card: the fix is a new card, not a cancellation, and both live behind this one link. deeprelay billing portal is an alias for the same command.

What cancelling does

Cancelling in the portal sets the subscription to end at the close of the current billing period. You keep plan coverage until then, and deeprelay billing subscription reports it:

Plan     Flat tier — $2.99 / month
Status   subscribed (active)
Cancels  at the end of the current period
Period   2026-09-01 → 2026-10-01 (UTC)

After the period ends, plan-covered models fall back to pay-as-you-go against your credit balance like any other model. Nothing stops working; it starts being charged. deeprelay preflight will say so before each call.

Permissions and errors

Requires an org admin API key with the billing write scope, the same as deeprelay billing subscribe.

Situation	Result
Organization has never paid for anything	`404` — there is no billing account to manage
Subscriptions not configured on this deployment	`503`
Not an org admin	`403`

A 404 here is not an error about your subscription — it means the org has no Stripe customer at all yet. Subscribe or add credit first.

Examples

# Open the portal.
deeprelay billing cancel

# Same command, said the other way.
deeprelay billing portal

# Just the URL.
deeprelay billing cancel --output json | jq -r .portal_url

deeprelay billing cancel [flags]

Options

  -h, --help                help for cancel
      --return-url string   Where Stripe returns when the customer leaves the portal (defaults to the server's configured URL)

Options inherited from parent commands

      --api-base string   API base URL (override with DEEPRELAY_API_BASE env) (default "https://api.deeprelay.ai/v1")
      --debug             Enable debug logging to stderr
      --no-preflight      Skip the plan/credit check before inference requests (override with DEEPRELAY_NO_PREFLIGHT env)
  -o, --output string     Output format: table|json (default table on TTY, json otherwise) (default "table")