Apps API · Billing Addons
Billing Addons: 1 endpoints
GET /api/v1/billing/addons/{id}/outstanding
Preview an agent add-on's pay-on-resume debt
Scope: billing:usage:read · Called with: appToken · operationId: get-billing-addon-outstanding
Required app scope: billing:usage:read.
Read-only preview of exactly what POST /api/v1/billing/addons/{id}/resume would charge to clear this add-on's outstanding debt (pay-on-resume) — the same per-item breakdown billing assembles byte-identically for the resume charge. total_outstanding_points 0 with an empty breakdown means there is no outstanding debt and the add-on can be resumed directly (resume will charge nothing). Requires org-owner or org-admin: the gate mirrors the resume route so the preview and the action it previews share one authz contract — the preview exposes billable debt detail, so only a member who could resume should see it. Response wrapped in standard envelope.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string | yes | Add-on id |
Responses
200OK —application/json·DataResponseAddonOutstandingDTOBodydefaultError —application/problem+json·D8Error
