API pipeline: Buy a Pro plan for up to 10 projects

Goal: buy a Pro plan (monthly, yearly or lifetime) that makes up to 10 of your projects Pro, attach and release projects, stop auto-renew.

Steps

1. Offer and state.

GET /v0/my/plan
→ {"active": false, "auto_renew": false, "projects": [], "slots": 10, "seats_total": 18, "seats_left": …,
   "project_usd": "18.00",
   "prices": [{"kind": "monthly", "usd": "81.00"}, {"kind": "yearly", "usd": "818.18"}, {"kind": "lifetime", "usd": "999.00"}]}

Prices above are those of 2026-10-15; read them from this call. lifetime is a limited beta offer (seats_left).

2. Quote with a coupon (optional). GET /v0/my/coupons/quote?coupon=<clip>&target=yearly → list_usd, discount_usd, charged_usd, enough. API pipeline: Redeem a coupon

3. Buy.

POST /v0/my/plan
{"kind": "monthly"}                 (optional "coupon": "<clip>")
→ {"active": true, "kind": "monthly", "until": "2026-11-15T10:00:00Z", "auto_renew": true, "projects": [], …,
   "list_usd": 81.0, "discount_usd": 0.0, "charged_usd": 81.0}

Buying again while a monthly or yearly plan is active adds its period after the current until (also to switch between monthly and yearly). Lifetime has no end.

4. Attach a project. POST /v0/my/plan/projects/<project> → the project, now Pro through the plan.

5. Release a project. DELETE /v0/my/plan/projects/<project> → the project, now Free; its campaigns and oracles stop.

6. Stop auto-renew. DELETE /v0/my/plan → "auto_renew": false; the plan stays until until.

Behind

• Renewal at until from the balance while auto_renew is on.
• Balance short at renewal: the plan lapses, the campaigns and oracles of its projects stop, and @CabiChatBot tells you.

Rules

• kind: monthly, yearly or lifetime; else 400.
• Insufficient balance → 400 insufficient funds: <price> USDT required for the <kind> plan; no seats → 400 no founding seats left; lifetime already held → 400 a lifetime plan is already active.
• Attach: no active plan → 400 no active plan; 10 used → 400 all plan slots are used. Release of a project not on the plan → 400 project is not on a plan slot.
• With a free slot, buying Pro for a single project is refused: use the slot. API pipeline: Make a project Pro

API surface

Index: API pipelines — index