Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
21 tools available
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.
Connect Cody to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Cody's 21 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Every Cody action below is a callable tool any Definable persona can invoke.
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.
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.
Tool to create a document by uploading a file (up to 100 MB). Supports txt, md, rtf, pdf, ppt, pptx, pptm, doc, docx, docm formats. Use when you need to add file-based documents to Cody's knowledge base. The file is processed asynchronously.
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.
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.
Tool to delete a conversation by its ID. Use when you need to permanently remove a conversation from the system.
Tool to delete a document by id. Use when removing a document that is no longer needed.
Tool to fetch a conversation by its ID from Cody AI. Use when you need to retrieve details about a specific conversation. Supports optional includes parameter to filter response to list document IDs.
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.
Tool to retrieve a specific folder by its identifier. Use when you need to get details about a folder.
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.
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.
Tool to get all bots with optional keyword filtering. Use when you need to retrieve the list of available bots in a Cody account.
Tool to get all conversations with optional filtering by bot, keyword, or includes. Use when you need to retrieve conversation history, filter by bot, search by name, or get document associations.
Tool to retrieve all documents from Cody AI account with optional filtering. Use when you need to list documents by folder, conversation, or search by keyword. Returns document details including learning status and content URL.
Tool to retrieve all folders with optional keyword filtering. Use when you need to list or search for folders in the account.
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).
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.
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.
Tool to update a conversation by its ID including name, bot_id, and document_ids. Use when you need to modify an existing conversation's properties.
Tool to update a folder by its ID. Use when you need to modify an existing folder's name.
Anything Cody exposes through its API. Common ai assistants workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 21 Cody tools directly, then chain the result into another integration without you writing code.
Cody uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Yes — every Definable plan, including Starter, includes access to all 21 Cody tools. You only need a separate Cody subscription if Cody itself charges per seat or per API call.
Every call from a persona to Cody is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
Sign up for Definable, open the integrations page, find Cody, and connect via OAuth or API key. You can immediately attach Cody to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 21 Cody actions as callable tools — including `Create Conversation`, `Create Document`, `Create Document From File`, plus 18 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.