Skip to main content

Invoke Task

POST 
/v1/agents/:agent_id/versions/:version_id/invoke-task

Invoke a Task agent with structured inputs validated against the agent's input schema. Unlike RAG/Tool agents that accept messages, Task agents accept key-value inputs that are rendered into the system prompt template. Use latest as the version_id to invoke the most recent version.

Status Codes:

  • 200: Task agent invoked successfully
  • 400: Validation error (invalid input or incompatible agent type)
  • 404: Agent or version not found
  • 500: Internal server error

Request​

Responses​

Successful Response