Subscriptions API

Activate a tier, query status. Subscriptions unlock platform features (priority queue, premium agents, faster SSE) — they no longer grant FLOW credits.

Subscriptions on AgentFlow are now feature gates, not credit grants. The previous monthly FLOW-credit grant model is gone with the move of $FLOW to an on-chain token. Subscriptions unlock platform-side features for marketplace and live build users.

Earlier docs referenced monthlyGrantFlow and currentGrantRemainingFlow. These fields are removed. If you have a billing system that depended on them, switch to feature checks (features.priorityQueue, features.premiumAgents, etc.).

Tiers

Tier	Monthly USD	Features
Plus	$20	Priority queue, basic analytics
Pro	$100	All Plus + premium agents, advanced analytics, faster SSE
Max	$200	All Pro + private project pages, dedicated runtime slot

Tier changes take effect at next billing period for downgrades, immediately for upgrades (pro-rated).

POST /subscriptions/checkout

Initiate a subscription checkout flow. Auth: required.

tier · string · required

One of plus, pro, max.

provider · string · required

One of cryptobot, platega, usdt_bep20.

curl -X POST https://api.agentflow.website/subscriptions/checkout \
  -H "Content-Type: application/json" \
  -H "Cookie: af_session=..." \
  -d '{ "tier": "pro", "provider": "cryptobot" }'

Response

{
  "subscriptionId": "sub_01HQ...",
  "tier": "pro",
  "provider": "cryptobot",
  "checkoutUrl": "https://t.me/CryptoBot?start=invoice-...",
  "expiresAt": "2026-04-26T11:30:00Z"
}

The checkoutUrl is provider-specific. Redirect the user there. Activation happens server-side once the provider’s webhook confirms.

GET /me/subscription

Fetch the current user’s active subscription. Auth: required.

curl https://api.agentflow.website/me/subscription \
  -H "Cookie: af_session=..."

Response

{
  "tier": "pro",
  "status": "active",
  "renewsAt": "2026-05-26T11:30:00Z",
  "provider": "cryptobot",
  "features": {
    "priorityQueue": true,
    "premiumAgents": true,
    "fasterSse": true,
    "privateProjects": false,
    "dedicatedRuntime": false
  }
}

status values: active, grace (failed renewal, retrying), canceled, none.

POST /me/subscription/cancel

Cancel at end-of-period. The user keeps the tier until renewsAt, then drops to none.

curl -X POST https://api.agentflow.website/me/subscription/cancel \
  -H "Cookie: af_session=..."

Auto-renew and grace

Subscriptions auto-renew through the same provider used at activation. If the renewal payment fails, the subscription enters a 7-day grace period during which features stay live and payment retries daily. After 7 days of failed retries the subscription is canceled.

Errors

Code	When
tier_unknown	Bad tier value
provider_unsupported	Provider not enabled in this deployment
subscription_active	New checkout while one is already active

Withdrawals are no longer handled through this endpoint group. With $FLOW on-chain, “withdrawal” simply means selling tokens via FlowProtocol.sell(...) directly from your wallet to the USDT pair. See Buy / Sell. The old /me/payouts endpoints are deprecated.