# Botpress

## Docs

- [Introduction to Studio](https://botpress-charmenta-pr-583.mintlify.site/studio/introduction.md): Development environment for building AI agents and chatbots.
- [Home](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/home.md): Main menu with global configuration for your bot.
- [Nodes](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/nodes/introduction.md)
- [Autonomous Node](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/nodes/autonomous-node.md)
- [Send Messages](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/cards/send-messages.md)
- [Tables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/cards/tables.md)
- [Set inactivity timeout](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/cards/set-inactivity-timeout.md)
- [Webchat](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/cards/webchat.md): Cards that allow you to interact with the Webchat widget.
- [Utilities](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/cards/utilities.md): Cards that provide utility in the Studio, and aren't part of your bot's Workflow.
- [Workflows](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/workflows.md)
- [Knowledge Bases](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/knowledge-base/introduction.md)
- [Add sources to Knowledge Base](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/knowledge-base/add-sources.md)
- [Knowledge Base Best Practices](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/knowledge-base/knowledge-base-best-practices.md): Set up Knowledge Bases effectively by prioritizing structured data, ensuring data quality, and using automated ingestion tools.
- [Tables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/tables.md)
- [Hooks](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/hooks.md)
- [Integrations](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/integrations.md): Allow your bot to connect to external services, APIs, and tools.
- [Schemas](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/schemas.md): Blueprint that defines the structure, format, and validation rules for data.
- [Versions](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/versions.md): View, compare, and revert to previous versions of your bot.
- [Find](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/find.md): Quickly search through your bot's content, Workflows, and configurations.
- [Variables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/overview.md): Containers for storing and reusing information in Botpress Studio.
- [Workflow variables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/scopes/workflow.md)
- [User variables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/scopes/user.md)
- [Conversation variables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/scopes/conversation.md)
- [Bot variables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/scopes/bot.md)
- [Configuration variables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/scopes/configuration.md)
- [Built-in variables](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/built-in.md)
- [Pass variables between Workflows](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/pass-between-workflows.md)
- [Use variables in code](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/variables/in-code.md)
- [Triggers](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/triggers.md)
- [Debugger, Logs & JSON](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/debugger-logs-json.md)
- [Emulator](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/emulator.md)
- [Import & Export](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/import-export-bots.md)
- [Copy to bot](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/copy-to-bot.md): Duplicate the configuration of a bot into another bot.
- [Keyboard Shortcuts](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/controls-and-settings/keyboard-shortcuts.md): Studio Keyboard Shortcuts
- [Commands](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/controls-and-settings/studio-commands.md)
- [Studio Preferences](https://botpress-charmenta-pr-583.mintlify.site/studio/concepts/controls-and-settings/studio-preferences.md)
- [Introduction](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/introduction.md)
- [Translate Webchat UI](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/how-to/translate.md)
- [Send reminders to conversations](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/how-to/send-reminders.md)
- [Use different LLM for Autonomous Nodes](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/how-to/different-an-models.md)
- [Track AI spend in a table](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/how-to/track-ai-spend-in-table.md)
- [Send options as a dropdown menu](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/how-to/dropdown-menus.md)
- [Using code in Studio](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/use-code.md)
- [Event Properties](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/event-properties.md)
- [State Management](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/best-practices-for-state-management.md): Manage the 128 KB state size limit in Botpress by optimizing Workflows, clearing unused variables, and minimizing large data usage.
- [Safety](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/safety/introduction.md): Botpress provides a robust feature set that ensure AI-driven interactions are safe, controlled, and compliant.
- [Preventing Abuse](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/safety/preventing-abuse.md)
- [Brand Safety Framework](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/safety/brand-safety-framework.md): Control AI responses, enforce brand-aligned messaging, and prevent harmful outputs.
- [Exporting Data](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/exporting-data/introduction.md): Export data from your bot using the Botpress API by requesting the relevant endpoint.
- [Raw Conversations](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/exporting-data/exporting-raw-conversations-with-the-botpress-api.md)
- [Conversation History](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/exporting-data/getting-the-conversation-history-from-within-your-bot.md)
- [Streaming Analytics](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/exporting-data/streaming-analytics-from-within-your-bot-with-hooks.md)
- [Compiled Bot Analytics](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/exporting-data/exporting-compiled-bot-analytics-with-the-botpress-api.md)
- [Accessing The Autonomous Nodes Thought Process](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/exporting-data/analyze-llmz-responses.md): Analyze Knowledge Base responses from Autonomous Nodes in Botpress with the “After LLMz Execution” hook.
- [Advanced Starter Template](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/kitchen-sink-advanced-starter-template.md)
- [Tips to optimize AI Cost](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/tips-to-optimize-ai-cost.md)
- [Retention Period](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/retention-period.md)
- [Botpress v12 (and self-hosted versions)](https://botpress-charmenta-pr-583.mintlify.site/studio/guides/advanced/v12.md)
- [Introduction to Webchat](https://botpress-charmenta-pr-583.mintlify.site/webchat/get-started/introduction.md): Integrate your bot into your website.
- [Quickstart](https://botpress-charmenta-pr-583.mintlify.site/webchat/get-started/quick-start.md): Use the Webchat embed code to add a bot to your website.
- [Embed Webchat in an element](https://botpress-charmenta-pr-583.mintlify.site/webchat/get-started/embed-in-element.md)
- [Configure Webchat](https://botpress-charmenta-pr-583.mintlify.site/webchat/get-started/configure-your-webchat.md)
- [Open/close your Webchat](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/open-close-webchat.md): Manually open or close Webchat on your website.
- [Use custom toggle to open/close Webchat](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/use-custom-toggle.md)
- [Display proactive bubble](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/proactive-message-bubble.md)
- [Automatically open Webchat on page load](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/open-webchat-on-page-load.md)
- [Send user data](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/send-user-data.md): Provide your bot with data about the current user.
- [Listen to events](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/listen-to-events.md): Listen for when Webchat opens, closes, raises an error, and more.
- [Trigger actions when conversation starts](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/start-trigger.md)
- [Display notification bubble](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/webchat-notification.md)
- [Send a message from user](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/send-message.md)
- [Send custom events from Webchat to your website](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/send-custom-events/from-webchat.md): Let your website know when something happens in your user's conversation.
- [Send custom events from your website to Webchat](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/send-custom-events/to-webchat.md)
- [Update Webchat configuration](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/update-config.md)
- [Error handling](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/error-handling.md)
- [Webchat methods reference](https://botpress-charmenta-pr-583.mintlify.site/webchat/interact/reference.md)
- [WordPress](https://botpress-charmenta-pr-583.mintlify.site/webchat/integrations/wordpress.md): Add a bot to your WordPress website using Webchat.
- [Wix](https://botpress-charmenta-pr-583.mintlify.site/webchat/integrations/wix.md): Add a bot to your Wix website using Webchat.
- [Webflow](https://botpress-charmenta-pr-583.mintlify.site/webchat/integrations/webflow.md): Add a bot to your Webflow website using Webchat.
- [React Native](https://botpress-charmenta-pr-583.mintlify.site/webchat/integrations/react-native.md): Add your bot in any React Native or Expo app using react-native-webview.
- [Get started](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/get-started.md): Install the Webchat React library and build your first component.
- [Webchat](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/components/webchat.md)
- [Floating Action Button](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/components/fab.md)
- [Container](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/components/container.md)
- [Header](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/components/header.md)
- [MessageList](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/components/message-list.md)
- [Composer](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/components/composer.md)
- [StylesheetProvider](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/components/stylesheet-provider.md)
- [useWebchat](https://botpress-charmenta-pr-583.mintlify.site/webchat/react-library/hooks/use-webchat-client.md)
- [CLI reference](https://botpress-charmenta-pr-583.mintlify.site/adk/cli-reference.md): All commands and flags available with the ADK CLI.
- [Introduction](https://botpress-charmenta-pr-583.mintlify.site/tutorial/introduction.md)
- [Prompting](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/first-steps/prompting.md)
- [Adding knowledge](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/first-steps/adding-knowledge.md)
- [Workflows](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/custom-logic/workflows.md)
- [Creating Nodes](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/custom-logic/creating-nodes.md)
- [Adding Cards](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/custom-logic/adding-cards.md)
- [Using custom logic with AI](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/custom-logic/using-custom-logic-with-ai.md)
- [Variables](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/storing-information/variables.md)
- [Assigning a value](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/storing-information/assigning-a-value.md)
- [Scoping variables](https://botpress-charmenta-pr-583.mintlify.site/tutorial/basics/storing-information/scoping-variables.md)
- [getAccount](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminaccountme.md): Get details of the account authenticating with this endpoint.
- [updateAccount](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/put-v1adminaccountme.md): Update details of the account associated with authenticated user
- [listPublicIntegrations](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminhubintegrations.md): List public integration
- [getPublicIntegrationById](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminhubintegrations-1.md): Get public integration by Id
- [getPublicIntegration](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminhubintegrations-.md): Get public integration by name and version
- [listBots](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminbots.md): List bots
- [createBot](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/post-v1adminbots.md): Create bot
- [getBot](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminbots-1.md): Get bot details
- [updateBot](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/put-v1adminbots.md): Update bot
- [deleteBot](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/delete-v1adminbots.md): Delete bot
- [getBotLogs](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminbots-logs.md): Get bot logs
- [getBotAnalytics](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminbots-analytics.md): Get bot analytics
- [getBotIssue](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminbots-issues.md): Get Bot Issue
- [deleteBotIssue](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/delete-v1adminbots-issues.md): Delete Bot Issue
- [listBotIssues](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminbots-issues-1.md): List Bot Issues
- [listBotIssueEvents](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminbots-issues-events.md): List Events for a Bot Issue
- [listWorkspaces](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminworkspaces.md): List workspaces the user has access to
- [createWorkspace](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/post-v1adminworkspaces.md): Create workspace
- [getPublicWorkspace](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminworkspaces-public.md): Get workspace public details
- [getWorkspace](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminworkspaces-1.md): Get workspace details
- [updateWorkspace](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/put-v1adminworkspaces.md): Update workspace
- [deleteWorkspace](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/delete-v1adminworkspaces.md): Delete workspace
- [listPublicWorkspaces](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminworkspacespublic.md): List public workspaces
- [getAuditRecords](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminworkspaces-audit-records.md): Get the audit records of a workspace, sorted from most recent to oldest.
- [listWorkspaceMembers](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminworkspace-members.md): Lists all the members in a workspace
- [createWorkspaceMember](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/post-v1adminworkspace-members.md): Add a member to the workspace
- [getWorkspaceMember](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminworkspace-membersme.md): Get details of the account authenticating with this endpoint.
- [updateWorkspaceMember](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/put-v1adminworkspace-members.md): Update the member of a workspace
- [deleteWorkspaceMember](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/delete-v1adminworkspace-members.md): Remove a member of a workspace
- [listIntegrations](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminintegrations.md): List integrations, supports filtering and sorting capabilities
- [createIntegration](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/post-v1adminintegrations.md): Create integration
- [validateIntegrationCreation](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/post-v1adminintegrationsvalidate.md): Perform a validation of an integration creation request
- [getIntegration](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminintegrations-1.md): Get integration
- [updateIntegration](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/put-v1adminintegrations.md): Update integration
- [deleteIntegration](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/delete-v1adminintegrations.md): Delete integration
- [validateIntegrationUpdate](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/put-v1adminintegrations-validate.md): Perform a validation of an integration update request
- [getIntegrationLogs](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminintegrations-logs.md): Get integration logs
- [getIntegrationByName](https://botpress-charmenta-pr-583.mintlify.site/api-reference/admin-api/openapi/endpoints/get-v1adminintegrations-.md): Get integration
- [listFiles](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/get-v1files.md): List files for bot
- [upsertFile](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/put-v1files.md): Creates or updates a file using the `key` parameter as unique identifier. Updating a file will erase the existing content of the file. Upload the file content by sending it in a PUT request to the `uploadUrl` returned in the response.
- [getFile](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/get-v1files-1.md): Get file
- [updateFileMetadata](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/put-v1files-1.md): Update file metadata, without updating the file content.
- [deleteFile](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/delete-v1files.md): Deletes a file.
- [copyFile](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/post-v1files-.md): Copy file
- [searchFiles](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/get-v1filessearch.md): Search files
- [listFilePassages](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/get-v1files-passages.md): List passages for a file
- [listFileTags](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/get-v1filestags.md): List available tags
- [listFileTagValues](https://botpress-charmenta-pr-583.mintlify.site/api-reference/files-api/openapi/endpoints/get-v1filestags-values.md): List available tags
- [listTables](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/get-v1tables.md): Retrieves a list of all tables associated with your bot.
- [createTable](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/post-v1tables.md): Initiates the creation of a new table based on the provided schema, excluding system-managed fields like IDs and timestamps.
- [getTable](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/get-v1tables-1.md): Retrieves detailed information about a specific table, identified by its name or unique identifier.
- [updateTable](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/put-v1tables.md): Updates the schema or the name of an existing table.
- [getOrCreateTable](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/post-v1tables-1.md): Retrieves information about a specific table if it exists; otherwise, creates a new table based on the provided schema.
- [deleteTable](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/delete-v1tables.md): Permanently deletes a table and all its associated data from the system. Use with caution, as this action cannot be undone.
- [duplicateTable](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/post-v1tables-duplicate.md): Duplicates the table schema & content
- [renameTableColumn](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/put-v1tables-column.md): Renames an existing column within a table to better reflect its content or usage. The operation targets a specific table and requires the current and new column names.
- [getTableRow](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/get-v1tables-row.md): Fetches a specific row from a table using the row's unique identifier.
- [findTableRows](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/post-v1tables-rowsfind.md): Enables the search and filtering of rows within a table based on specific criteria. This operation supports complex queries for advanced data manipulation and retrieval.
- [updateTableRows](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/put-v1tables-rows.md): Updates specified rows in a table, allowing partial success with detailed feedback on errors.
- [createTableRows](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/post-v1tables-rows.md): Inserts one or multiple new rows into the specified table.
- [deleteTableRows](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/post-v1tables-rowsdelete.md): Allows selective deletion of rows or complete clearance of a table.
- [upsertTableRows](https://botpress-charmenta-pr-583.mintlify.site/api-reference/tables-api/openapi/endpoints/post-v1tables-rowsupsert.md): Inserts or updates rows based on a key. If a row exists, it is updated; otherwise, a new row is created.
- [listConversations](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatconversations.md): Retrieves a list of [Conversation](#schema_conversation) you’ve previously created. The conversations are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](#tags).
- [createConversation](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatconversations.md): Creates a new [Conversation](#schema_conversation). When creating a new [Conversation](#schema_conversation), the required tags must be provided. See the specific integration for more details.
- [getConversation](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatconversations-1.md): Retrieves the [Conversation](#schema_conversation) object for a valid identifier.
- [updateConversation](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/put-v1chatconversations.md): Update a [Conversation](#schema_conversation) object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
- [deleteConversation](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/delete-v1chatconversations.md): Permanently deletes a [Conversation](#schema_conversation). It cannot be undone. Also immediately deletes corresponding [Messages](#schema_message).
- [getOrCreateConversation](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatconversationsget-or-create.md): Retrieves the [Conversation](#schema_conversation) object containing given tags. If the conversation does not exist, it will be created. Tags will be updated if they are set in the request body.
- [listParticipants](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatconversations-participants.md): Retrieves a list of [Participant](#schema_participant) for a given [Conversation](#schema_conversation).
- [addParticipant](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatconversations-participants.md): Add a [Participant](#schema_participant) to a [Conversation](#schema_conversation).
- [getParticipant](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatconversations-participants-1.md): Retrieves a [Participant](#schema_participant) from a [Conversation](#schema_conversation).
- [removeParticipant](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/delete-v1chatconversations-participants.md): Remove a [Participant](#schema_participant) from a [Conversation](#schema_conversation).
- [listEvents](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatevents.md): Retrieves a list of [Event](#schema_event) you’ve previously created. The events are returned in sorted order, with the most recent appearing first.
- [createEvent](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatevents.md): Creates a new [Event](#schema_event). When creating a new [Event](#schema_event), the required tags must be provided. See the specific integration for more details.
- [getEvent](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatevents-1.md): Retrieves the [Event](#schema_event) object for a valid identifiers.
- [cancelScheduledEvent](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/delete-v1chateventsscheduled.md): Permanently cancels a scheduled [Event](#schema_event). The event must be in a `scheduled` state.
- [listMessages](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatmessages.md): Retrieves a list of [Message](#schema_message) you’ve previously created. The messages are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](/docs/developers/concepts/tags).
- [createMessage](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatmessages.md): Creates a new [Message](#schema_message). When creating a new [Message](#schema_message), the required tags must be provided. See the specific integration for more details.
- [getOrCreateMessage](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatmessagesget-or-create.md): Retrieves the [Message](#schema_message) object for given discriminating tags. If the message does not exist, it will be created. If the message already exists, its tags and payload will be updated with the provided values if they are defined.
- [getMessage](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatmessages-1.md): Retrieves the [Message](#schema_message) object for a valid identifier.
- [updateMessage](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/put-v1chatmessages.md): Updates a message tags and payload. The message type cannot be changed. Calling this operation from an integration, to update an incoming message, will not invoke the bot. The other way around it also true; Calling this operation from the bot, to update an outgoing message, will not invoke the integ…
- [deleteMessage](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/delete-v1chatmessages.md): Permanently deletes a [Message](#schema_message). It cannot be undone.
- [listUsers](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatusers.md): Retrieves a list of [User](#schema_user) previously created. The users are returned in sorted order, with the most recent appearing first. The list can be filtered using [Tags](/docs/developers/concepts/tags).
- [createUser](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatusers.md): Creates a new [User](#schema_user). When creating a new [User](#schema_user), the required tags must be provided. See the specific integration for more details.
- [getUser](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatusers-1.md): Retrieves the [User](#schema_user) object for a valid identifier.
- [updateUser](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/put-v1chatusers.md): Update a [User](#schema_user) object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
- [deleteUser](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/delete-v1chatusers.md): Permanently deletes a [User](#schema_user). It cannot be undone.
- [getOrCreateUser](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatusersget-or-create.md): Retrieves the [User](#schema_user) object for given discriminating tags. If the user does not exist, it will be created. If the user already exists, its name, pictureUrl, attributes, and tags will be updated with the provided values.
- [setStateExpiry](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatstates--expiry.md): Updates the [State](#schema_state) expiry.
- [getState](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chatstates-.md): Retrieves the [State](#schema_state) object for a valid identifiers.
- [setState](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatstates-.md): Overrides the [State](#schema_state) object by setting the values of the parameters passed.
- [patchState](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/patch-v1chatstates-.md): Updates the [State](#schema_state) object by setting the values of the parameters passed.
- [getOrSetState](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatstates--get-or-set.md): Retrieves the [State](#schema_state) object for a valid identifiers. If the state does not exist, it creates a new state.
- [callAction](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatactions.md): Call an action
- [configureIntegration](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/post-v1chatintegrationsconfigure.md): An integration can call this endpoint to configure itself
- [listTagValues](https://botpress-charmenta-pr-583.mintlify.site/api-reference/runtime-api/openapi/endpoints/get-v1chattags-values.md): Get a bot tag values

## OpenAPI Specs

- [tables-openapi](https://botpress-charmenta-pr-583.mintlify.site/tables-openapi.json)
- [runtime-openapi](https://botpress-charmenta-pr-583.mintlify.site/runtime-openapi.json)
- [files-openapi](https://botpress-charmenta-pr-583.mintlify.site/files-openapi.json)
- [chat-openapi](https://botpress-charmenta-pr-583.mintlify.site/chat-openapi.json)
- [admin-openapi](https://botpress-charmenta-pr-583.mintlify.site/admin-openapi.json)

## Optional

- [Community Discord](https://discord.com/invite/botpress)
- [News & Resources](https://botpress.com/blog)
- [Botpress Desk](https://desk.support.channel)