StateSet API Docs

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/quota' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "plan_name": "string",
  "period_tasks_used": 1,
  "task_quota": 1,
  "remaining": 1,
  "is_exhausted": true,
  "billing_period_start": "string",
  "billing_period_end": "string"
}

GET

api

quota

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/quota' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "plan_name": "string",
  "period_tasks_used": 1,
  "task_quota": 1,
  "remaining": 1,
  "is_exhausted": true,
  "billing_period_start": "string",
  "billing_period_end": "string"
}

Pre-flight quota check. Cheaper than /usage when all you need to know is ‘can I send another batch right now?’ — skips the lifetime aggregation across UsageRecord and the by-status job count.

Response

QuotaResponse

string,null

Subscription plan label, or None if no subscription is on file.

integer

required

integer

required

integer

required

Convenience: max(quota - used, 0).

boolean

required

True iff remaining == 0. Tenants can branch on this without arithmetic.

string,null

Status codes

Code	Meaning
`200`	Successful Response

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/quota' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "plan_name": "string",
  "period_tasks_used": 1,
  "task_quota": 1,
  "remaining": 1,
  "is_exhausted": true,
  "billing_period_start": "string",
  "billing_period_end": "string"
}

Overview

Jobs

Trigger

Templates

Skills

Custom agents

Approvals

Approval policies

Outcomes

Usage

Quota

Billing

Webhooks

Keys

Auth

System

Health

Events

Tags

Get Quota V1

Response

Status codes

​Response

​Status codes

Response

Status codes