Retrieve a knowledge base file
Poll this until status is ready or failed. Requires knowledge_bases:read.
Authorizations
Your Wixzel Voice API key: Authorization: Bearer wv_live_.... Keys are scoped; grant only what the integration needs.
Path Parameters
^[0-9a-f]{24}$"6a96a3ead6e886d42462dd3e"
^[0-9a-f]{24}$"6a96a3ead6e886d42462dd3e"
Response
The file
A file in a knowledge base. A document’s text is read and split into passages; an agent using the knowledge base searches them during a call with the built-in search_knowledge tool. An image or video is found by its description. The original is kept so agents can send it on WhatsApp.
^[0-9a-f]{24}$"6a96a3ead6e886d42462dd3e"
knowledge_file ^[0-9a-f]{24}$"6a96a3ead6e886d42462dd3e"
image and video are for agents to send on WhatsApp; they are found by their description.
pdf, docx, txt, md, csv, html, image, video Characters of text read from it.
Passages the agent can search.
processing while it is read (usually seconds); ready once agents can search it; failed with error saying why.
processing, ready, failed Why it failed, or a note on a ready file (such as only part of it being kept).
What the file is or shows. Required for images and videos.
Whether agents can send it on WhatsApp: its original was kept. Files added before WhatsApp sending was available are not.
ISO 8601, always UTC.
"2026-09-01T12:00:00.000Z"

