Refine a brief

View as Markdown

Re-shapes a settled brief (status shaped/failed) with optional updated text, returning the brief id and a fresh shaping WebSocket ticket. A non-refinable status or an in-progress approval returns 409.

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.
textstringOptional1-10000 characters

Response

The brief id and shaping WebSocket ticket.
briefIdstring
wsTicketstring

Signed ticket for the shaping-log WebSocket.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error