Runs
Available from Phases 3 to 4b
/api/v1/runsAn app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).
In: header
Query Parameters
1 <= length0 < value <= 9007199254740991Value in
- "production"
- "staging"
- "pinned"
- "draft"
Value in
- "console"
- "playground"
- "api"
- "embed"
- "extension"
- "mcp"
- "eval"
- "cli"
- "ingest"
Value in
- "ok"
- "error"
- "rate_limited"
- "quota_exceeded"
Value in
- "high"
- "medium"
- "low"
Value in
- "auto"
- "review"
- "fallback"
- "escalate_to_llm"
date-timedate-time1 <= value <= 200501 <= lengthResponse Body
application/json
application/json
curl -X GET "https://example.com/api/v1/runs"{ "data": [ null ], "nextCursor": "string"}/api/v1/runs/{id}An app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).
In: header
Path Parameters
uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/api/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08"null/api/v1/runs/ingestAn app token (sk_live_, sk_test_, pk_live_), a browser token (a 5-minute ES256 JWT) or an agent token (sa_live_).
In: header
Header Parameters
Required for app and agent tokens on mutations. A replay within 24 hours returns the stored response.
1 <= lengthRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/v1/runs/ingest" \ -H "Content-Type: application/json" \ -d '{ "setRef": "string", "version": 1, "model": "string", "answers": { "property1": { "type": "noul", "noul": 0, "property1": null, "property2": null }, "property2": { "type": "noul", "noul": 0, "property1": null, "property2": null } }, "usage": { "input_tokens": 0, "output_tokens": 0, "property1": null, "property2": null }, "latencyMs": 0, "stateHash": "string" }'nullBandwise is an independent product built on TypeSafe's System One models. It is not TypeSafe's documentation. For the System One models themselves, see docs.typesafe.ai.