Fetch a compose job's full ensemble state
Required permission: projects:read
AuthorizationBearer <token>
API key auth. Prefix cf_live_ for production orgs, cf_test_ for sandbox.
In: header
Path Parameters
id*string
composeJobId*string
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/projects/string/compose/jobs/string"{ "composeJobId": "string", "projectId": "string", "status": "queued", "request": { "suggestionId": "string", "fromComposition": true, "scope": null, "critique": "string", "parentJobId": "string", "maxCandidates": 0, "budgetUsd": 0, "qualityThreshold": 0 }, "candidates": [ null ], "winner": { "candidateIndex": 0, "compositionRunId": "string" }, "cost": { "llmUsd": 0, "visionUsd": 0, "modalUsd": 0, "totalUsd": 0 }, "startedAt": 0, "completedAt": 0}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}Start an async Director compose workflow POST
Async sibling of `composeFromSuggestion`. The Director Temporal workflow authors a canonical wire-shape Composition and saves it to `projects.composition`. Watch progress via the SSE stream at `/v1/projects/:id/compose/:composeJobId/stream`.
List recent compose jobs for a project GET
Required permission: projects:read