compose

Promote a compose candidate to the active composition

Selects one candidate from a finished compose ensemble and writes it to the project's composition. selectStrategy decides how the editor draft interacts with the write (per compose-api-contract.md).

post/v1/projects/{id}/compose/jobs/{composeJobId}/select

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/projects/{id}/compose/jobs/{composeJobId}/select
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: projects:write)
    • API key in header PAYMENT-SIGNATURE

Path parameters

idstring required
composeJobIdstring required

Request body

candidateIndexinteger required
selectStrategy'agent-authoritative' | 'editor-merge' | 'editor-replace' required
ifMatchstring

Response

Candidate selected; etag returned for adoption.

newCompositionEtagstring required

Changes

No recorded changes to this operation across all 1 revision of this API.