CommetCommet
GitHubDiscordStatus
Add quota POSTList quota allowances GETGet quota allowance GETRemove quota POSTSet quota PUT
DocumentaciónRecursosConstruir con AIAPI ReferenceWebhooks

Add quota

Add to a customer's quota allowance for a feature. Defaults to 1 if count is omitted.

POST
/usage/quota

Add to a customer's quota allowance for a feature. Defaults to 1 if count is omitted.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Header Parameters

Idempotency-Key?string

Unique key used to safely retry this write for 24 hours without applying it twice.

Length1 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/usage/quota" \  -H "Content-Type: application/json" \  -d '{    "featureCode": "string",    "customerId": "string"  }'
{  "id": "quota_1a2b3c4d",  "customerId": "cus_1a2b3c4d",  "featureCode": "projects",  "previousBalance": 2,  "newBalance": 3,  "ts": "2026-09-07T12:00:00.000Z",  "createdAt": "2026-09-07T12:00:00.000Z",  "object": "usage_quota_event",  "livemode": false}
{  "error": {    "type": "validation_error",    "code": "validation_error",    "message": "The request contains an invalid parameter.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/validation_error.md"  }}
{  "error": {    "type": "authentication_error",    "code": "unauthorized",    "message": "A valid API key is required.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/unauthorized.md"  }}
{  "error": {    "type": "authentication_error",    "code": "forbidden",    "message": "You do not have permission to perform this operation.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/forbidden.md"  }}
{  "error": {    "type": "not_found_error",    "code": "not_found",    "message": "The requested resource was not found.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/not_found.md"  }}
{  "error": {    "type": "conflict_error",    "code": "idempotency_in_progress",    "message": "A request with this idempotency key is still being processed.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/idempotency_in_progress.md"  }}
{  "error": {    "type": "rate_limit_error",    "code": "rate_limited",    "message": "Too many requests. Retry after the interval specified in the Retry-After header.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/rate_limited.md"  }}
{  "error": {    "type": "internal_error",    "code": "internal_error",    "message": "An unexpected error occurred while processing the request.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/internal_error.md"  }}
{  "error": {    "type": "internal_error",    "code": "idempotency_unavailable",    "message": "Idempotency storage is temporarily unavailable. Retry with the same idempotency key.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/idempotency_unavailable.md"  }}

Create claim link POST

Issue a fresh claim link for an organization that was provisioned headlessly and has not been claimed yet. Any previously issued link stops working.

List quota allowances GET

Get all quota allowances for a customer across every quota feature in their plan.

featureCode*string
Match^[a-z0-9_]+$
Length1 <= length <= 50
count?integer
Range0 < value <= 9007199254740991
Default1
customerId*string
Length1 <= length <= 200