Change the paid plan
Changes Starter or Pro and interval for an existing subscription.
POST /api/v1/billing/change-plan
OpenAPI operation changeBillingPlan. Authenticate with a Clerk session JWT (Authorization: Bearer {jwt}) or the verbafy_guest_session cookie. {jwt} is a Clerk session token after you sign in on the website. Verbafy does not issue that token and does not show it in Settings. For scripts and agents, sign in, create an API key at Settings → API keys, and call Remote MCP with Authorization: Bearer sk-…. Credential setup: Auth.md. Machine-readable contract: OpenAPI.
Request example
curl -X POST 'https://verbafy.io/api/v1/billing/change-plan' \
-H 'Authorization: Bearer {jwt}' \
-H 'Content-Type: application/json' \
-d '{"plan":"starter","interval":"monthly"}'Responses
| Status | Description |
|---|---|
200 | Changed plan |
400 | Validation or domain request error |
401 | Missing or invalid Clerk Bearer token or guest session |
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.
Revoke the current Guest session
Clears the guest cookie and revokes the hashed token. DELETE /api/v1/auth/guest-sessions/current on the Verbafy REST API.
Convert a paid-plan trial
Ends a paid-plan trial on the same plan so the period becomes billed. POST /api/v1/billing/convert-trial on the Verbafy REST API.