aVenture APIBilling

Create or recover a hosted Checkout Session

View as Markdown
Start the selected AI Plus or AI Pro plan through hosted Checkout. A caller with a continuing subscription manages it through a Billing Portal Session instead.

Authentication

AuthorizationBearer

User bearer token: Clerk session JWT, Clerk OAuth access token, or Clerk API key

Request

This endpoint expects an object.
planenumRequired
AI Plus or AI Pro plan to start through hosted Checkout
Allowed values:

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

Created
expiresAtdatetime
planenum
Canonical paid billing plan offered by aVenture.
Allowed values:
urlstringformat: "uri"

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error