> ## 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.

# Charla

> Charla is a live chat and AI customer-support platform whose public API manages property contacts, conversation exports, and knowledge base articles and categories.

![Charla logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/charla.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=58d45990edd0e1f856192686012c111b)

* **Category:** communication
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `CHARLA`
* **Version:** 00000000\_00

## Tools

> [accordion] Create Knowledge Base Article
>
> **Slug:** `CHARLA_CREATE_KB_ARTICLE`
>
> Create a knowledge base article. Charla generates its URL slug from the title and may use it for chatbot training according to the property's AI settings. Defaults to a private draft.
>
> #### Input Parameters
>
> **title** `string`
>
> Article title. Omit only when Charla should store an untitled article.
>
> **status** `string ("Draft" | "Published")`
>
> Initial publication status. Draft is the safer default.
>
> **visibility** `string ("Private" | "Public")`
>
> Initial article visibility. Private is the safer default.
>
> **description** `string`
>
> Short article summary or description.
>
> **category\_ids** `array` *required*
>
> IDs of existing knowledge base categories to assign. Use List Knowledge Base Categories to discover them.
>
> **content\_html** `string`
>
> Article body as HTML.
>
> #### 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 Knowledge Base Article
>
> **Slug:** `CHARLA_DELETE_KB_ARTICLE`
>
> Permanently delete one knowledge base article by ID. This cannot be undone, and deleting an already-missing article fails.
>
> #### Input Parameters
>
> **article\_id** `integer` *required*
>
> Numeric ID of the knowledge base article to permanently delete. Deletion cannot be undone.
>
> #### 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 Contact
>
> **Slug:** `CHARLA_GET_CONTACT`
>
> Return one contact in the connected Charla property by UUID.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> UUID of the contact 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 Knowledge Base Article
>
> **Slug:** `CHARLA_GET_KB_ARTICLE`
>
> Return the full content and metadata of one knowledge base article by ID.
>
> #### Input Parameters
>
> **article\_id** `integer` *required*
>
> Numeric ID of the knowledge base article 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] List Contacts
>
> **Slug:** `CHARLA_LIST_CONTACTS`
>
> Return one page of contacts for the connected Charla property, ordered by most recently modified.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Continuation cursor from the previous response. Omit for the first page and pass it back unchanged to fetch the next page.
>
> #### 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:** `CHARLA_LIST_CONVERSATIONS`
>
> Export one page of conversations grouped by contact for the connected Charla property, including message history.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Continuation cursor from the previous response; omit for the first page and pass it back unchanged to fetch the next page.
>
> #### 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 Knowledge Base Articles
>
> **Slug:** `CHARLA_LIST_KB_ARTICLES`
>
> Return one page of knowledge base article summaries for the connected Charla property, newest first.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Continuation cursor from the previous response. Omit for the first page and pass the returned value back unchanged.
>
> #### 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 Knowledge Base Categories
>
> **Slug:** `CHARLA_LIST_KB_CATEGORIES`
>
> Return all knowledge base categories available in the connected Charla property.
>
> #### 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 Knowledge Base Article
>
> **Slug:** `CHARLA_UPDATE_KB_ARTICLE`
>
> Replace every writable field of an existing knowledge base article. Charla regenerates the URL slug from the replacement title and may retrain chatbot content according to the property's AI settings.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Complete replacement title for the article.
>
> **status** `string ("Draft" | "Published")` *required*
>
> Replacement publication status.
>
> **article\_id** `integer` *required*
>
> Numeric ID of the existing article to update.
>
> **visibility** `string ("Private" | "Public")` *required*
>
> Replacement article visibility.
>
> **description** `string` *required*
>
> Complete replacement article summary. Pass an empty string to clear it.
>
> **category\_ids** `array` *required*
>
> Complete replacement category ID set. Confirm current associations with List Knowledge Base Articles because a single-article read may omit them.
>
> **content\_html** `string` *required*
>
> Complete replacement article body as HTML.
>
> #### 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
