Renew an agent subscription
POST/agent-subscriptions/:id/renew
Extends the subscription's currentPeriodEnd by another intervalDays from the plan (starting from the later of today or the current period end) and re-activates it if it was past_due. Cancelled subscriptions cannot be renewed. Emits agent_subscription.renew audit event. Requires the agent-subscription:renew permission.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 429
- 500
Updated AgentSubscription with new period end.
Subscription cancelled or invalid state.
Missing or invalid access token.
Caller lacks the required permission.
Subscription not found.
Rate limit exceeded. Global default is 120 requests/minute per IP; auth-flow, OTP, self-registration, WebAuthn, IRA lookup, and public-lead endpoints carry tighter per-endpoint limits. Retry after the delay indicated by the Retry-After header.
Response Headers
Seconds to wait before retrying.
Unhandled server error. The response carries a meta.requestId correlator you can hand to platform operations to trace the failure through structured logs and the hash-chained audit trail. Retry with the same Idempotency-Key header if the endpoint accepts idempotency.