COcomposal
agent

Discover the next canonical conversation input

Internal trusted Activity port. A short-lived conversation-scoped credential fixes the controlling principal, agent, conversation and lifecycle. The request is empty. Returns only an authorized input locator and short-lived input dispatch credential, or nulls when parked/caught up; no message bodies or execution permission. Never place credentials in workflow history.

post/api/v1/agent/persistent/conversations/next_input

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/conversations/next_input
  • Auth
    HTTP bearer

Request body

object required

Response

Next eligible input and scoped credential, or paired nulls. Response must not be cached.

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

Trusted Activity transport only; not a workflow payload.

Changes

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