agent

Finalize a direct foreground segment

Publish the canonical outcome for a SQL direct conversation through its original scoped worker identity. Exact acknowledged retries return the same receipt after retirement; this endpoint grants no inference or tool authority. Current read access and canonical model/tool settlement remain required.

post/api/v1/agent/persistent/segments/finalize

Request

  • Base URL
    https://composal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://composal.com/api/v1/agent/persistent/segments/finalize
  • Auth
    HTTP bearer

Request body

Response

No-store trusted Activity response

organization_idstring required
agent_idstring required
task_idstring required
operation_keystring required
conversation_idstring required
versionstring required
outcome'completed' | 'waiting' | 'failed' required
checkpoint_sequenceinteger required

Changes

No recorded changes to this operation across all 4 revisions of this API.