API Reference
Start a run
Queues one execution of every workflow prompt against every model of the domain. Fails when none of the picked prompts is left in the wallet.
AuthorizationBearer <token>
Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
In: header
Path Parameters
domainId*string
Public UUID of the domain
workflowId*string
Public UUID of the workflow
Response Body
application/json
curl -X POST "https://example.com/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/workflows/7c9e6679-7425-40de-944b-e07fc1f90ae7/runs"{ "run": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "workflowId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "domainId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "organizationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "triggeredBy": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "triggerSource": "manual", "market": "US", "language": "en", "status": "completed", "errorMessage": "No prompts left in the wallet", "completedAt": "2026-05-25T10:30:00.000Z", "createdAt": "2026-05-25T10:30:00.000Z", "updatedAt": "2026-05-25T10:30:00.000Z", "results": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "runId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "promptId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "promptText": "What are the best running shoes?", "modelId": "chatgpt", "modelName": "ChatGPT", "rawResponse": "For neutral runners, the usual picks are...", "sources": [ { "url": "https://techcrunch.com/2026/01/10/running-shoes", "title": "The best running shoes of 2026", "text": "Testers favoured the lighter midsole..." } ], "analyzerOutputType": "boolean", "analyzerOutputNumber": 7, "analyzerOutputBoolean": true, "analyzerOutputJson": { "brands": [ "Nike", "Adidas" ] }, "analyzerRawResponse": "{\"value\": true}", "executionTimeMs": 4200, "error": "Upstream timeout", "createdAt": "2026-05-25T10:30:00.000Z" } ] }, "openRunId": null}