> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cody

> Cody is an AI-powered assistant that uses the magic of ChatGPT meets the expertise of a custom-made AI assistant trained on your specific business.

![Cody logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/cody.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=5de861b4ccdde6d650ee0207efa1708d)

* **Category:** ai assistants
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 21
* **Triggers:** 0
* **Slug:** `CODY`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Conversation
>
> **Slug:** `CODY_CREATE_CONVERSATION`
>
> Tool to create a new conversation with a specified bot. Use when starting a new conversation thread with optional focus mode to limit bot's knowledge base to specific documents.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The conversation name.
>
> **bot\_id** `string` *required*
>
> The bot identifier to use for this conversation.
>
> **document\_ids** `array`
>
> List of document IDs to enable focus mode. Only documents that exist in the folders the bot has access to are allowed. Maximum 1,000 elements.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Document
>
> **Slug:** `CODY_CREATE_DOCUMENT`
>
> Tool to create a new document with text or HTML content in Cody AI. Use when you need to add documents to Cody's knowledge base with up to 768 KB of content.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The document name.
>
> **content** `string` *required*
>
> Up to 768 KB of text or HTML content for the document. This field is required.
>
> **folder\_id** `string` *required*
>
> ID of the folder to store the document. This field is required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Document From File
>
> **Slug:** `CODY_CREATE_DOCUMENT_FROM_FILE`
>
> Create a Cody knowledge-base document from a previously uploaded file key in a destination folder. The file is processed asynchronously.
>
> #### Input Parameters
>
> **key** `string` *required*
>
> The key received after uploading a file via the /uploads/signed-url endpoint. This key identifies the uploaded file to be converted into a document.
>
> **folder\_id** `string` *required*
>
> ID of the destination folder for the document. This is required by the API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Document from Webpage
>
> **Slug:** `CODY_CREATE_DOCUMENT_FROM_WEBPAGE`
>
> Tool to create a document from a publicly accessible webpage URL. Use when you need to import content from a webpage into Cody AI. The webpage must be accessible without login. If request fails, ensure the URL is publicly accessible and not blocked by a firewall.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Valid and publicly accessible webpage URL. The webpage must be accessible without login or authentication.
>
> **folder\_id** `string` *required*
>
> The folder identifier where the document will be stored.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Folder
>
> **Slug:** `CODY_CREATE_FOLDER`
>
> Tool to create a new folder in Cody AI for organizing content. Use when you need to create a folder to organize documents or conversations.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the folder to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Conversation
>
> **Slug:** `CODY_DELETE_CONVERSATION`
>
> Tool to delete a conversation by its ID. Use when you need to permanently remove a conversation from the system.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the conversation to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Document
>
> **Slug:** `CODY_DELETE_DOCUMENT`
>
> Tool to delete a document by id. Use when removing a document that is no longer needed.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The document identifier to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversation
>
> **Slug:** `CODY_GET_CONVERSATION`
>
> Fetch details of a Cody AI conversation by its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the conversation to retrieve.
>
> **includes** `string`
>
> Filters response to list document IDs the conversation focuses on. Accepts value: 'document\_ids'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Document
>
> **Slug:** `CODY_GET_DOCUMENT`
>
> Tool to retrieve a specific document by its identifier from Cody AI. Use when you need to get details about a particular document including its status, content URL, and metadata.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the document to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Folder
>
> **Slug:** `CODY_GET_FOLDER`
>
> Tool to retrieve a specific folder by its identifier. Use when you need to get details about a folder.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the folder to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Message
>
> **Slug:** `CODY_GET_MESSAGE`
>
> Tool to fetch a specific message by its ID from Cody AI. Use when you need to retrieve details about a particular message, with optional includes for sources or usage metrics.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the message to retrieve.
>
> **includes** `string`
>
> Extra attributes to include in the response. Accepted values are 'sources' (to include source documents) or 'usage' (to include token and credit consumption metrics). Separate multiple values with commas.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Upload Signed URL
>
> **Slug:** `CODY_GET_UPLOADS_SIGNED_URL`
>
> Tool to get an AWS S3 signed upload URL for file uploads. Use when you need to obtain a signed URL to upload a file to Cody's storage.
>
> #### Input Parameters
>
> **file\_name** `string` *required*
>
> Original file name you want to upload, must contain the file extension.
>
> **content\_type** `string` *required*
>
> MIME content type of the file.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bots
>
> **Slug:** `CODY_LIST_BOTS`
>
> List a page of bots in a Cody account, optionally filtering by keyword. Pagination metadata is returned for navigating additional pages.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results. Defaults to 1 if not specified.
>
> **keyword** `string`
>
> Keyword to filter the list of bots to only those that at least partially match the bot name.
>
> **per\_page** `integer`
>
> Number of results per page. Defaults to 15 if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Conversations
>
> **Slug:** `CODY_LIST_CONVERSATIONS`
>
> List a page of conversations, optionally filtering by bot or name keyword and including document associations. Pagination metadata is returned for navigating additional pages.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results. Defaults to 1 if not specified.
>
> **bot\_id** `string`
>
> Filters conversations to those using a specific bot. Provide the bot's unique identifier.
>
> **keyword** `string`
>
> Filters conversations by partial match against conversation names. Case-insensitive search.
>
> **includes** `string`
>
> When set to 'document\_ids', returns document IDs the conversation focuses on. Use this to get additional context about conversations.
>
> **per\_page** `integer`
>
> Number of results per page. Defaults to 15 if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Documents
>
> **Slug:** `CODY_LIST_DOCUMENTS`
>
> List a page of documents from a Cody AI account, optionally filtered by folder, conversation, or keyword. Returns document details including learning status and content URL, along with pagination metadata.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results. Defaults to 1 if not specified.
>
> **keyword** `string`
>
> Keyword to filter the list to documents that partially match the name. Use for searching documents by name.
>
> **per\_page** `integer`
>
> Number of results per page. Defaults to 15 if not specified.
>
> **folder\_id** `string`
>
> Id of the folder to list documents for. Use to filter documents by folder.
>
> **conversation\_id** `string`
>
> Id of the conversation to only list documents the conversation is focused on. Use to filter documents by conversation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Folders
>
> **Slug:** `CODY_LIST_FOLDERS`
>
> List a page of folders in the account, optionally filtered by keyword, with pagination metadata.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results. Defaults to 1 if not specified.
>
> **keyword** `string`
>
> Keyword to filter the list to folders that partially match the name.
>
> **per\_page** `integer`
>
> Number of results per page. Defaults to 15 if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Messages
>
> **Slug:** `CODY_LIST_MESSAGES`
>
> Tool to retrieve a paginated list of messages from Cody, optionally filtered by conversation. Use when you need to list messages, with optional filtering by conversation\_id and extra attributes (sources or usage).
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results. Defaults to 1 if not specified.
>
> **includes** `string`
>
> Extra attributes to include in the response. Accepted values are 'sources' (to include source documents) or 'usage' (to include token and credit consumption metrics). Separate multiple values with commas.
>
> **per\_page** `integer`
>
> Number of results per page. Defaults to 10 if not specified.
>
> **conversation\_id** `string`
>
> Filters results to messages within a specific conversation. Provide the conversation ID to narrow down results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Message
>
> **Slug:** `CODY_SEND_MESSAGE`
>
> Tool to send a message to Cody AI and receive an AI-generated response. Use when you need to send a user message to a conversation and get the AI's reply.
>
> #### Input Parameters
>
> **content** `string` *required*
>
> User message text to send (maximum 2000 characters).
>
> **conversation\_id** `string` *required*
>
> Identifier for the conversation thread to send the message to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Message for Stream
>
> **Slug:** `CODY_SEND_MESSAGE_FOR_STREAM`
>
> Tool to send a message to Cody AI and receive a Server-Sent Events (SSE) stream URL for the AI response. Use when you need streaming responses instead of waiting for the complete message. The response contains a stream\_url that can be used to connect to the SSE stream and receive the AI's response in real-time chunks.
>
> #### Input Parameters
>
> **content** `string` *required*
>
> The message content to send to the AI (maximum 2000 characters).
>
> **redirect** `boolean`
>
> Controls response format. When false (default), returns 200 with stream URL in JSON. When true, returns 302 redirect to stream URL.
>
> **conversation\_id** `string` *required*
>
> ID of the conversation to send the message to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Conversation
>
> **Slug:** `CODY_UPDATE_CONVERSATION`
>
> Update a conversation by ID with its name and bot ID, optionally setting document IDs to limit the bot's knowledge base.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the conversation to update.
>
> **name** `string` *required*
>
> The conversation name to update.
>
> **bot\_id** `string` *required*
>
> The bot associated with this conversation.
>
> **document\_ids** `array`
>
> Document IDs to limit the bot's knowledge base. Only documents that exist in the folders the bot has access to are allowed. Maximum 1,000 elements.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Folder
>
> **Slug:** `CODY_UPDATE_FOLDER`
>
> Tool to update a folder by its ID. Use when you need to modify an existing folder's name.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the folder to update.
>
> **name** `string` *required*
>
> The new name for the folder.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
