Skip to content

Read a channel's quota usage snapshot

Read-only remaining/capacity snapshot from the RateBudget DO plus a 24h aggregate of trigger-path quota skips (recentQuotaSkips) from D1. Snapshot may be null when the RATE_BUDGET binding is unavailable.

projectId
required
string

Tenant project id (row-level isolation on every query).

id
required
string

Resource id.

Quota snapshot (shape depends on RateBudget DO) plus recentQuotaSkips.

Media typeapplication/json
object
recentQuotaSkips
object
key
additional properties
any
key
additional properties
any

Not authenticated (no valid session/principal).

Media typeapplication/json
object
error
required

Human-readable error message.

string
message
string
Examplegenerated
json
{
"error": "example",
"message": "example"
}

Authenticated but lacks the required project role.

Media typeapplication/json
object
error
required

Human-readable error message.

string
message
string
Examplegenerated
json
{
"error": "example",
"message": "example"
}

Resource not found (or belongs to another project — indistinguishable).

Media typeapplication/json
object
error
required

Human-readable error message.

string
message
string
Examplegenerated
json
{
"error": "example",
"message": "example"
}