Get File Upload URL

Get a signed file upload URL for uploading a file to the knowledge base. Returns a URL for uploading via PUT and a key to use when creating a document from the uploaded file.

Send Message for Stream

Send a message in a conversation discovered with list_conversations and get a streaming URL for receiving the AI response as Server-Sent Events (SSE). Useful for real-time progressive rendering of responses.

Get Conversation

Retrieve a conversation by its ID. Call list_conversations to discover available conversations.

Get Document

Retrieve a knowledge base document's learning status and content URL. Call list_documents to discover document IDs.

Delete Document

Permanently delete a knowledge base document. Call list_documents to discover document IDs.

Create Document from Content

Create a knowledge base document from text or HTML content. Call list_folders to discover the target folder. Structured HTML with headings and paragraphs yields best results for the AI.

List Documents

Retrieve knowledge base documents. Filter by folder, conversation (focus mode documents), or search by keyword.

Send Message

Send a message within a conversation discovered with list_conversations and receive the AI-generated response based on the bot's knowledge base. Returns the full response in a single call.

Delete Conversation

Permanently delete a conversation and its message history. Call list_conversations to discover conversation IDs.

Create Document from File

Create a knowledge base document from a previously uploaded file. Requires a key obtained from the "Get File Upload URL" tool after uploading the file.

List Messages

Retrieve message history for a conversation discovered with list_conversations. Returns both user messages and AI-generated responses.

List Folders

Retrieve all folders used to organize your knowledge base documents. Optionally filter by name keyword.

Get Folder

Retrieve a knowledge base folder by its ID. Call list_folders to discover available folders.

Create Conversation

Start a new conversation with an AI bot discovered with list_bots. Optionally enable focus mode by specifying document IDs to restrict the bot's knowledge to only those documents.

List Bots

Retrieve all AI bots configured in your Cody account. Bots are AI assistants set up with access to specific knowledge base folders and customized behavior. Optionally filter by name keyword.

Create Document from Webpage

Create a knowledge base document by crawling a publicly accessible webpage URL. Call list_folders to discover the target folder. Cody will ingest the page content automatically.

Create Folder

Create a new folder to organize knowledge base documents.

Update Conversation

Update a conversation's name, bot, or focus mode documents. Call list_conversations and list_bots to discover IDs.

Update Folder

Rename an existing knowledge base folder. Call list_folders to discover folder IDs.

List Conversations

Retrieve conversations with AI bots. Filter by bot or search by keyword.

Get Message

Retrieve a message by an ID from list_messages or send_message, including content and metadata about whether it was AI-generated.

Download Document

Download a knowledge base document as an HTML file. Call list_documents to discover the document ID.