agent

Discover and prepare the next input for a trusted conversation worker

Dedicated scheduler transport only. Rails selects the current owner and ordered input and performs canonical task admission. Returns only locators, preparation and a short-lived input-scoped attachment token; never private message content or model/tool authority. Retry reuses the original task/workflow identity. Never save the response in Temporal history.

post/api/v1/agent/persistent/scheduler/prepare_next_task

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/scheduler/prepare_next_task
  • Auth
    HTTP bearer

Request body

organization_idstring required
agent_idstring required
conversation_idstring required

Response

Prepared exact input, or null input/token/preparation when no input is currently eligible.

organization_idstring required
agent_idstring required
conversation_idstring required
input_idstring nullable required
dispatch_tokenstring nullable required

Changes

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