API Overview

Base URL

https://api.cueapi.ai

All API endpoints are prefixed with /v1/ except health checks.

Authentication

Most endpoints require a Bearer token in the Authorization header:

Authorization: Bearer cue_sk_YOUR_API_KEY

Endpoints that do not require authentication:

• GET /health — system diagnostics
• GET /status — lightweight health check
• POST /v1/auth/device-code — create device code
• POST /v1/auth/device-code/poll — poll device code
• POST /v1/auth/device-code/submit-email — submit email
• GET /v1/auth/verify — magic link verification

Rate limits

Requests are rate-limited per plan using a sliding window:

Rate limit headers are included on every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
Retry-After: 12          (only on 429)

When exceeded, the API returns 429 Too Many Requests.

Error format

All errors follow a consistent JSON structure:

{
  "error": {
    "code": "cue_not_found",
    "message": "Cue not found: cue_abc123def456",
    "status": 404
  }
}

See Error Codes for the complete list.

Request limits

• Body size: 2 MB maximum (returns 413 Payload Too Large)
• Webhook timeout: 30 seconds
• Outcome metadata: 10 KB maximum

Endpoints

Cues

Executions

Auth

Billing

Usage

Worker

Health