Billing

Confirm the first workspace and purchase

Creates the signed-in Owner's first Workspace and one checkout attempt bound to the confirmed purchase choice. Exact retries resume the same attempt.

post/billing/welcome

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/billing/welcome
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Request body

$schemastring uri

A URL to the JSON Schema for this object.

billing_period'monthly' | 'annual' required

Canonical billing period

plan_idstring required

Canonical hosted plan ID

purchase_choice_tokenstring required

Integrity-protected purchase choice carried through signup

return_pathstring

Validated same-origin route to resume after checkout

workspace_namestring required

Name for the first Workspace

Example request

{
  "$schema": "https://example.com/api/v1/schemas/ConfirmFirstWorkspacePurchaseInputBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

organization_idstring required
workspace_idstring required
workspace_namestring required

Example response

{
  "$schema": "https://example.com/api/v1/schemas/ConfirmFirstWorkspacePurchaseOutputBody.json",
  "checkout": {
    "$schema": "https://example.com/api/v1/schemas/BillingURLResponse.json"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.