apicheats.dev Cheat sheet Raw .md
POST

Try POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query — ElevenLabs API

ElevenLabs playground

Query Agent Knowledge Base Rag

Credentials

Kept in this tab only. Requests go through apicheats.dev's same-origin proxy straight to api.elevenlabs.io; the proxy stores and logs nothing about them.

Path

Query

Body application/json

4 body fields
  • query · required · string — Query to run against the agent's knowledge base RAG index.
  • use_agent_defaults · optional · boolean — When true (the default), retrieval uses the agent's own RAG settings, reproducing exactly what the agent would retrieve. Set to false to retrieve with neutral default RAG settings instead (the agent's embedding model is always kept, since it determines which vector index exists). Useful for auditing the knowledge base independently of how a particular agent is tuned.
  • max_documents_length · optional · integer — Optional maximum total character length of document chunks returned. Overrides the selected RAG settings for this query only.
  • max_retrieved_rag_chunks_count · optional · integer — Optional maximum number of document chunks retrieved. Overrides the selected RAG settings for this query only.