Skip to main content

Invoke Agent

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

Invoke a RAG or Tool agent with the provided messages and return the complete response. Use latest as the version_id to invoke the most recent version. The request body accepts messages, optional guardrails, and agent-type-specific parameters such as hxqlQuery for RAG agents.

Status Codes:

  • 200: 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