Skip to content
Extrovert Extrovert Docs

Create a Stripe Checkout Session for an Extrovert paid plan

POST
/v1/admin/orgs/{org_id}/billing/checkout

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
org_id
required
string

Header Parameters

Section titled “Header Parameters ”
Idempotency-Key
string

Optional client-supplied key making a CREATE exactly-once. A retry with the same key returns the ORIGINAL response (same status + body) instead of creating a duplicate; the same key with a different request body returns 409. The body field client_id is honored as an alias when this header is absent. The key is scoped per tenant (and per agent on the agent plane), so keys never collide across callers.

Request Body required

Section titled “Request Body required ”
object
plan_tier
required
string
Allowed values: developer startup
success_url
required
string format: uri
cancel_url
required
string format: uri

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Created

object
id
required

Stripe Checkout Session id.

string
url
required
string format: uri
status
required
string
plan_tier
required
string
Allowed values: developer startup
mode
required
string
Allowed values: test live
subscription
required
object
org_id
required
string
customer_id
required
string
plan_tier
required
string
Allowed values: free developer startup enterprise
status
required
string
stripe_customer_id
string
stripe_subscription_id
string
stripe_subscription_item_id
string
stripe_price_id
string
current_period_start
string format: date-time
current_period_end
string format: date-time
cancel_at_period_end
required
boolean

400

Section titled “400 ”

Invalid request.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

401

Section titled “401 ”

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

403

Section titled “403 ”

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

503

Section titled “503 ”

A required integration or server-side capability is not configured.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope