Gallery Platform API
Reference

Open the billing portal

Creates a hosted Stripe Billing Portal session for the organization's billing account and returns its URL. Fails with a conflict when the organization has never checked out.

POST
/org/billing/portal

Creates a hosted Stripe Billing Portal session for the organization's billing account and returns its URL. Fails with a conflict when the organization has never checked out.

Authorization

bearerAuth billing:create
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: billing:create

Header Parameters

Idempotency-Key?string

Optional. Send a unique key per logical operation to make retries safe: a retry with the same key replays the stored success for 14 days instead of re-running the write. Reusing a key with a different body returns 400.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "url": "string"}

Start a plan checkout POST

Creates a hosted Stripe Checkout session that subscribes the organization to the requested paid plan, and returns its URL. Fails with a conflict while a live subscription exists — use the billing portal to switch plans.

Get the organization's plan entitlements GET

Returns the organization's plan, its allowances (quota limits + feature flags), and current usage against those limits.