# Chatfai

ChatFAI is an AI-powered platform that enables users to engage in interactive conversations with AI-generated versions of their favorite fictional characters from various media.

- **Category:** ai chatbots
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `CHATFAI`
- **Version:** 20260223_00

## Tools

### Get Public Character By ID

**Slug:** `CHATFAI_GET_PUBLIC_CHARACTER_BY_ID`

Tool to retrieve a public character by its ID. Use when you need to fetch details of a single public character by providing its unique ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the public character to retrieve. You can obtain character IDs by searching for characters using CHATFAI_SEARCH_PUBLIC_CHARACTERS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Conversations

**Slug:** `CHATFAI_LIST_CHATFAI_CONVERSATIONS`

Tool to list conversations for the authenticated user. Use when you need to retrieve the user's chat conversations or verify authentication status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of conversations to return per page. Use this to control pagination. |
| `cursor` | string | No | Pagination cursor from the previous response's nextCursor field. Use this to fetch the next page of conversations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Characters

**Slug:** `CHATFAI_SEARCH_CHARACTERS`

Tool to search for public characters on ChatFAI by name or keyword. Use when you need to find characters matching a specific search query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Search query string to find characters by name or keyword. Enter the character name or relevant terms to discover matching public characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |