RakerOne APIBriefs

Approve a brief

View as Markdown

Materializes the (user-edited) shaped proposal under a single commit anchor — creating the proposed data objects, the playbook, and the initial run — then starts the run. Idempotent for an already-approved brief (Fork-A replay). Requires project:manage + playbook:start (plus data-object:manage when creating data objects).

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

projectIdstringRequired
briefIdstringRequired

Request

This endpoint expects an object.
playbookobjectRequired
initialRunobjectOptionalDefaults to {"startData":{},"taskAssignments":{},"attachedFileIds":[]}
createDataObjectslist of objectsOptionalDefaults to []

Response

An already-approved brief — the materialized ids (Fork-A replay).

shapedPlaybookIdstring or null
shapedRunIdstring or null
replayedboolean

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error