Upgrade to a paid plan
upgradeGet a Stripe Checkout link for a paid plan, for a human to open.
This tool cannot subscribe anybody. It returns a url; a person has to open it and enter a card on Stripe's own page. Hand the URL to the human you are working for and say what it costs. Nothing is charged, and no plan changes, until they finish on that page — at which point Stripe tells Galley and the new plan is live within a second or two. Confirm with usage.
Use it when a render was refused with quota_exceeded, or with plan_required because the account is on Free and asked for webhooks or cloud delivery. The error body names the plan that would have worked.
The account needs a verified email address first — invoices and receipts go to it — so call create_account before this if you are on the keyless trial. Changing or cancelling an existing plan is billing_portal, never this. Free.
If billing is not enabled on the deployment this is pointed at, the call is refused with billing_unavailable (503) rather than answered with a link. That is deliberate: the alternative is a URL on a domain that does not resolve, which you cannot tell apart from a real one. On that error, say so and point the human at https://galleyrender.com/pricing. Do not construct a checkout URL yourself and do not retry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan | Yes | Which paid plan to subscribe to. Solo $5/mo (200 PDF pages or 500 images, webhooks, cloud delivery), Starter $19/mo (2,000 PDF pages or 5,000 images), Growth $79/mo (12,000 PDF pages or 30,000 images, priority queue, 90-day retention), Scale $249/mo (60,000 PDF pages or 150,000 images, dedicated pool, SLA). Call `usage` first if you are not sure which one the current volume needs. There is no `free`: moving down a plan is a cancellation in the billing portal, which is `billing_portal`. | |
| interval | No | Billing interval. Default `month`. `year` is ten months for twelve on every plan. |