API Quickstart

Use this flow after you create an API key in workspace settings.

1. Inspect the API index

curl https://app.citlyze.com/api/v1 \
  -H "Authorization: Bearer aeo_live_..."

The index lists resource paths, accepted parameters, supported formats, and the current MCP endpoint path.

curl "https://app.citlyze.com/api/v1/prompts?limit=100" \
  -H "Authorization: Bearer aeo_live_..."

JSON responses include pagination metadata:

{
  "pagination": {
    "limit": 100,
    "offset": 0,
    "has_more": true
  }
}

Increase offset until has_more is false.

curl "https://app.citlyze.com/api/v1/runs?format=csv&limit=5000" \
  -H "Authorization: Bearer aeo_live_..." \
  -o runs.csv

CSV responses use a stable header row for the selected resource.

The API index includes:

{
  "mcp_endpoint": "/api/mcp"
}

Use https://app.citlyze.com/api/mcp when configuring MCP clients.