Apps API · Billing Credits
Billing Credits: 5 个接口
GET /api/v1/billing/agent-credit-caps
List agent credit caps (monthly and daily)
权限(scope): billing:usage:read · 调用方式: appToken · operationId: list-billing-agent-credit-caps
Required app scope: billing:usage:read.
回包
200OK —application/json·DataResponseListAgentCreditCapDTOBodydefaultError —application/problem+json·D8Error
GET /api/v1/billing/agents/{identity_id}/monthly-cap
Get an agent credit cap (monthly and daily)
权限(scope): billing:usage:read · 调用方式: appToken · operationId: get-billing-agent-credit-cap
Required app scope: billing:usage:read.
参数
| 名字 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
identity_id |
path | string (uuid) | 是 |
回包
200OK —application/json·DataResponseAgentCreditCapDTOBodydefaultError —application/problem+json·D8Error
GET /api/v1/billing/auto-topup-settings
Get auto top-up settings
权限(scope): billing:usage:read · 调用方式: appToken · operationId: get-billing-auto-topup-settings
Required app scope: billing:usage:read.
Returns the caller org's auto top-up configuration plus the deployment-level feature_enabled flag. Any org member. Response wrapped in standard envelope.
回包
200OK —application/json·DataResponseAutoTopupSettingsDTOBodydefaultError —application/problem+json·D8Error
GET /api/v1/billing/balance-alert-settings
Get balance alert settings
权限(scope): billing:usage:read · 调用方式: appToken · operationId: get-billing-balance-alert-settings
Required app scope: billing:usage:read.
Returns the caller org's absolute credit-balance alert threshold. has_threshold=false means no absolute threshold is configured — the burn-rate tiers (7/3/1 days of projected runway) stay active regardless, as they are a system measurement rather than a preference. Any org member. Response wrapped in standard envelope.
回包
200OK —application/json·DataResponseBalanceAlertSettingsDTOBodydefaultError —application/problem+json·D8Error
GET /api/v1/billing/credit-grants
List credit grant batches
权限(scope): billing:usage:read · 调用方式: appToken · operationId: list-billing-credit-grants
Required app scope: billing:usage:read.
Lists every credit grant batch with source, original amount, current remaining amount, expiry, and lifecycle status. Page-based: increment page while pagination.has_more is true. Any org member. Response wrapped in standard envelope.
参数
| 名字 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
page |
query | integer (int32) | Page number (1-based; default: 1) | |
page_size |
query | integer (int32) | Grant batches per page (default: 50, max: 100) | |
order_by |
query | string | Sorting is not supported yet; any non-empty value is rejected with 400 |
回包
200OK —application/json·BillingPageListResponseCreditGrantDTOBodydefaultError —application/problem+json·D8Error
