Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The key or ID of the agent to invoke
Body
Optional task ID to continue an existing agent execution. When provided, the agent will continue the conversation from the existing task state. The task must be in an inactive state to continue.
Optional variables for template replacement in system prompt, instructions, and messages
Information about the contact making the request. If the contact does not exist, it will be created automatically.
Thread information to group related requests
Memory configuration for the agent execution. Used to associate memory stores with specific entities like users or sessions.
Optional metadata for the agent invocation as key-value pairs that will be included in traces
Response
Agent task created successfully
A2A Task response format
The ID of the created agent execution task
The correlation ID for this execution
A2A entity type
task Task status information
Task metadata containing workspace_id and trace_id for feedback