DocumentationSDKsCLIAPI Reference
Console
Projects

List a project's generations

GET
/projects/{project_id}/generations

Authorization

apiKey
AuthorizationBearer <token>

API key from the console, ak_....

In: header

Path Parameters

project_id*string

Query Parameters

limit?integer
Range1 <= value <= 100
cursor?string
language?string

Only generations for this language.

Value in

  • "typescript"
  • "python"
  • "go"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/projects/string/generations"
{  "data": [    {      "id": "string",      "object": "generation",      "files_omitted": true,      "files_index": [        {          "path": "string",          "bytes": 0        }      ],      "project_id": "string",      "status": "succeeded",      "trigger": "manual",      "language": "typescript",      "meta": {        "title": "string",        "version": "string",        "spec_format": "openapi",        "oas_version": "string",        "converted": true,        "package_name": "string",        "client_name": "string",        "targets": [          "sdk"        ],        "resource_count": 0,        "operation_count": 0,        "schema_count": 0,        "paginated_operation_count": 0,        "omitted_operation_count": 0,        "pr_url": "string",        "pr_number": 0,        "changelog": "string",        "breaking_count": 0,        "baseline": "destination",        "semver": "success",        "semver_note": "string",        "previous_version": "string",        "file_count": 0,        "total_lines": 0      },      "warnings": [        "string"      ],      "files": [        {          "path": "string",          "content": "string"        }      ],      "error": "string",      "created_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}

Run a hosted generation POST

Fetches the project's spec URL, generates every configured language, and stores each result in the project's history. Each language counts as one hosted generation. Does not open pull requests. Only URL-sourced projects can be regenerated this way; repository sources regenerate on push.

Retrieve hosted MCP endpoint usage for a project GET

What the project's hosted MCP endpoint has served over the last `days` (default 30, max 90): tool calls, calls that returned an error, calls turned away by the rate limit, mean upstream latency, and a per-tool breakdown. The same numbers the console shows next to the endpoint URL. Zeroes when the endpoint is off or unused.