API referenceBilling
Start a legacy Free workspace's grace period (owners and admins)
Called by the console when an owner or admin opens it: a workspace still on the retired Free plan gets its 14 day grace period from now (and its owners and admins an email). Idempotent, and a no-op in any other state. A Free workspace that never signs in gets the same grace at its first connection attempt. Requires billing:manage.
Authorization
apiKey AuthorizationBearer <token>
Long-lived tenant API key, cd_live_… (production) or cd_test_… (staging, development), stored hashed. Keys created before the switch to cd_ start with sk_live_… / sk_test_… and are still accepted. Scoped to the owning application's tenant.
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/billing/grace:start"{ "started": true, "state": "trialing", "grace_ends_at": "2019-08-24T14:15:22Z", "days_left": 0}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}