# Wit.ai

Wit.ai is a natural language processing platform that enables developers to build applications and devices that understand human language.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 31
- **Triggers:** 0
- **Slug:** `WIT_AI`
- **Version:** 20260227_00

## Tools

### Add Entity Keyword

**Slug:** `WIT_AI_ADD_ENTITY_KEYWORD`

Tool to add a keyword with optional synonyms to a Wit.ai entity. Use when extending entity values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity` | string | Yes | Entity ID or name to add the keyword to |
| `keyword` | string | Yes | Keyword value to add to the entity |
| `synonyms` | array | No | List of synonyms for the keyword |

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

### Add Keyword Synonym

**Slug:** `WIT_AI_ADD_KEYWORD_SYNONYM`

Tool to add a new synonym to a keyword in an entity. Use when expanding entity keyword recognition with additional terms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity` | string | Yes | Entity ID or name to add the synonym to |
| `keyword` | string | Yes | Keyword within the entity to add the synonym to |
| `synonym` | string | Yes | Synonym value to add to the keyword |

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

### Add Value to Trait

**Slug:** `WIT_AI_ADD_TRAIT_VALUE`

Tool to add a new value to an existing trait in Wit.ai. Use when extending trait vocabulary with additional values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trait` | string | Yes | Trait ID or name to add the value to. |
| `value` | string | Yes | The value to add to the trait. |

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

### Create Wit.ai App

**Slug:** `WIT_AI_CREATE_APP`

Tool to create a new app in Wit.ai. Use when you need to programmatically initialize an application before training or importing data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | Yes | Locale code for the application |
| `name` | string | Yes | Name of the new Wit.ai application |
| `private` | boolean | No | Whether the app is private. Defaults to true |

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

### Create Wit.ai Entity

**Slug:** `WIT_AI_CREATE_ENTITY`

Tool to create a new entity in Wit.ai. Use when defining custom entity types for natural language understanding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new entity |
| `roles` | array | Yes | List of roles for the entity (at least one role required) |
| `lookups` | array | No | Lookup strategies for the entity: 'free-text' or 'keywords' |
| `keywords` | array | No | Initial keywords for the entity (required when lookups includes 'keywords') |

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

### Create Wit.ai Intent

**Slug:** `WIT_AI_CREATE_INTENT`

Tool to create a new intent in Wit.ai. Use when you need to define a new intent for natural language understanding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the intent to create. Must be unique within the app. |

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

### Create Wit.ai Trait

**Slug:** `WIT_AI_CREATE_TRAIT`

Tool to create a new trait in Wit.ai. Use when defining custom entity attribute matching behavior.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Unique name for the trait to create. |
| `values` | array | Yes | List of trait values; must include at least one value. |
| `lookups` | array | No | Lookup strategies to use (e.g., ['free_text']). |
| `mutually_exclusive` | boolean | No | If true, only one value can match per message. |

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

### Create Wit.ai Training Utterances

**Slug:** `WIT_AI_CREATE_UTTERANCES`

Tool to add training utterances (samples with annotations) to your Wit.ai app. Use when you need to train your model with labeled examples. Rate limit: 200 samples per minute.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `utterances` | array | Yes | Array of utterances to add for training. Rate limit: 200 samples per minute |

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

### Delete App

**Slug:** `WIT_AI_DELETE_APP`

Tool to delete a specific app from wit.ai. Use when you need to remove an existing app by its ID after confirming its existence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | string | Yes | The unique identifier of the app to delete |
| `access_token` | string | No | Optional access token to use for this request. If provided, this will override the default token. |

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

### Delete Entity

**Slug:** `WIT_AI_DELETE_ENTITY`

Tool to permanently delete an entity by name. Use when you need to remove an existing entity from the wit.ai app.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity` | string | Yes | Entity ID or name to delete |

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

### Delete Entity Keyword

**Slug:** `WIT_AI_DELETE_ENTITY_KEYWORD`

Tool to delete a keyword from a keywords entity in wit.ai. Use when you need to remove a specific keyword from an entity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity` | string | Yes | Entity ID or name from which to delete the keyword |
| `keyword` | string | Yes | Keyword to delete from the entity |

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

### Delete Entity Role

**Slug:** `WIT_AI_DELETE_ENTITY_ROLE`

Tool to delete a specific role from an entity in wit.ai. Use when you need to remove a role association from an entity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string | Yes | Role name to delete from the entity |
| `entity` | string | Yes | Entity ID or name from which to delete the role |

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

### Delete Intent

**Slug:** `WIT_AI_DELETE_INTENT`

Tool to permanently delete an intent by name. Use when you need to remove an intent from the app.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `intent` | string | Yes | Intent ID or name to delete |

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

### Delete Keyword Synonym

**Slug:** `WIT_AI_DELETE_KEYWORD_SYNONYM`

Tool to delete a synonym from a keyword in an entity. Use when you need to remove a specific synonym mapping from an entity keyword.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity` | string | Yes | Entity ID or name from which to delete the synonym |
| `keyword` | string | Yes | Keyword from which to delete the synonym |
| `synonym` | string | Yes | Synonym to delete from the keyword |

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

### Delete Utterances

**Slug:** `WIT_AI_DELETE_UTTERANCES`

Tool to delete validated utterances (training samples) from your Wit.ai app. Use when you need to remove specific training data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `utterances` | array | Yes | Array of utterance objects with text to delete. Must contain at least one utterance. |

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

### Wit.ai Detect Language

**Slug:** `WIT_AI_DETECT_LANGUAGE`

Tool to detect the language of a given text input. Returns detected locales with confidence scores. Use when you need to identify the language of user-provided text.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of locales to return (default is 1) |
| `q` | string | Yes | Text to detect language from |

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

### Export App Data

**Slug:** `WIT_AI_EXPORT_APP`

Tool to export Wit.ai app data as a backup ZIP file. Returns a download URL for the backup file containing all app data.

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

### Get App Details

**Slug:** `WIT_AI_GET_APP`

Tool to retrieve metadata and settings of a Wit.ai app. Use when you need to fetch complete app details by app ID after authenticating.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | string | Yes | ID of the Wit.ai app to retrieve |
| `access_token` | string | No | App-specific access token; if provided, overrides default Authorization header |

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

### Get Entity Details

**Slug:** `WIT_AI_GET_ENTITY`

Tool to retrieve details of a specific entity including keywords and roles. Use when you need entity metadata by ID or name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity` | string | Yes | Entity ID or name to retrieve |

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

### Get Intent Details

**Slug:** `WIT_AI_GET_INTENT`

Tool to retrieve details of a specific intent. Use when you need full intent metadata given its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `intent_id` | string | Yes | ID of the intent to retrieve |

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

### Get Intents

**Slug:** `WIT_AI_GET_INTENTS`

Tool to list all intents in a Wit.ai app. Use after authenticating to retrieve defined intents.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of intents to return (default: 100, max: 200) |
| `offset` | integer | No | Number of items to skip before starting to collect the result set (default: 0) |

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

### Wit.ai Get Message

**Slug:** `WIT_AI_GET_MESSAGE`

Tool to analyze a text message and extract its intent, entities, and traits. Use when you need structured meaning from user input.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Maximum number of outcomes to return (default is 1) |
| `q` | string | Yes | Text message to analyze for intent and entities |
| `context` | string | No | JSON-stringified context object for conversation |

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

### Get Trait Details

**Slug:** `WIT_AI_GET_TRAIT`

Tool to retrieve details of a specific trait. Use when you have the trait ID and need its full metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trait_id` | string | Yes | Unique identifier of the trait to retrieve |

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

**Slug:** `WIT_AI_GET_TRAITS`

Tool to list all traits in a Wit.ai app. Use after authenticating to retrieve defined traits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `v` | string | No | API version to use, as a date (YYYYMMDD) or '20230215' for the current supported version. Defaults to latest stable if omitted. |

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

### Get Voice Details

**Slug:** `WIT_AI_GET_VOICE`

Tool to retrieve details for a specific text-to-speech voice. Use when you need information about available styles and parameters for a voice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `voice` | string | Yes | Voice name to retrieve details for (e.g., 'wit$rebecca', 'wit$charlie') |

#### 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 Wit.ai Apps

**Slug:** `WIT_AI_LIST_APPS`

Tool to retrieve the list of all Wit.ai apps for the authenticated user. Use when you need to fetch apps with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | Yes | Maximum number of apps to return (required parameter) |
| `offset` | integer | No | Number of apps to skip before starting to collect the result set |

#### 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 App Tags

**Slug:** `WIT_AI_LIST_APP_TAGS`

Tool to retrieve all tag groups (versions) for a Wit.ai app. Use when you need to list available versions or snapshots of an app's state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app` | string | Yes | App ID to retrieve tags for |

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

**Slug:** `WIT_AI_LIST_ENTITIES`

Tool to list all entities in a Wit.ai app. Use after authenticating to retrieve defined entities.

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

**Slug:** `WIT_AI_LIST_UTTERANCES`

Tool to retrieve training utterances (samples) from a Wit.ai app. Use when you need to view or analyze the app's training data. Supports filtering by intents, entities, and traits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of utterances to return |
| `offset` | integer | No | Number of utterances to skip before starting to collect the result set |
| `traits` | array | No | Filter utterances by specific trait names |
| `intents` | array | No | Filter utterances by specific intent names |
| `entities` | array | No | Filter utterances by specific entity names |

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

**Slug:** `WIT_AI_LIST_VOICES`

Tool to retrieve all available text-to-speech voices grouped by locale. Use when you need to discover which voices are available for speech synthesis.

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

### Update Wit.ai App

**Slug:** `WIT_AI_PUT_APP`

Tool to update an existing Wit.ai app. Use when you need to modify app settings after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | Yes | Fields and values to update on the app |
| `app_id` | string | Yes | The unique identifier of the app to update |
| `access_token` | string | No | App-specific access token; if provided, overrides default Authorization header. Required when updating an app you created. |

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