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

# Wit.ai

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

![Wit.ai logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/wit_ai.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=180fca371a22dd06775ed46a93aaed64)

* **Category:** artificial intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 31
* **Triggers:** 0
* **Slug:** `WIT_AI`
* **Version:** 20261101\_00

## Tools

> [accordion] 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
>
> **entity** `string` *required*
>
> Entity ID or name to add the keyword to
>
> **keyword** `string` *required*
>
> Keyword value to add to the entity
>
> **synonyms** `array`
>
> List of synonyms for the keyword
>
> #### 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] 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
>
> **entity** `string` *required*
>
> Entity ID or name to add the synonym to
>
> **keyword** `string` *required*
>
> Keyword within the entity to add the synonym to
>
> **synonym** `string` *required*
>
> Synonym value to add to the keyword
>
> #### 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] 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
>
> **trait** `string` *required*
>
> Trait ID or name to add the value to.
>
> **value** `string` *required*
>
> The value to add to the trait.
>
> #### 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] 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
>
> **lang** `string` *required*
>
> Locale code for the application
>
> **name** `string` *required*
>
> Name of the new Wit.ai application
>
> **private** `boolean`
>
> Whether the app is private. Defaults to true
>
> #### 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] 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
>
> **name** `string` *required*
>
> Name of the new entity
>
> **roles** `array` *required*
>
> List of roles for the entity (at least one role required)
>
> **lookups** `array`
>
> Lookup strategies for the entity: 'free-text' or 'keywords'
>
> **keywords** `array`
>
> Initial keywords for the entity (required when lookups includes 'keywords')
>
> #### 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] 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
>
> **name** `string` *required*
>
> Name of the intent to create. Must be unique within the app.
>
> #### 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] Create Wit.ai Trait
>
> **Slug:** `WIT_AI_CREATE_TRAIT`
>
> Create a new Wit.ai trait using value strings and optional lookup and mutually exclusive settings. Expressions and metadata supplied for trait values are not sent.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Unique name for the trait to create.
>
> **values** `array` *required*
>
> List of trait values; must include at least one value.
>
> **lookups** `array`
>
> Lookup strategies to use (e.g., \['free\_text']).
>
> **mutually\_exclusive** `boolean`
>
> If true, only one value can match per message.
>
> #### 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] 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
>
> **utterances** `array` *required*
>
> Array of utterances to add for training. Rate limit: 200 samples per minute
>
> #### 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 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
>
> **app\_id** `string` *required*
>
> The unique identifier of the app to delete
>
> **access\_token** `string`
>
> Optional access token to use for this request. If provided, this will override the default token.
>
> #### 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 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
>
> **entity** `string` *required*
>
> Entity ID or name to delete
>
> #### 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 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
>
> **entity** `string` *required*
>
> Entity ID or name from which to delete the keyword
>
> **keyword** `string` *required*
>
> Keyword to delete from the entity
>
> #### 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 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
>
> **role** `string` *required*
>
> Role name to delete from the entity
>
> **entity** `string` *required*
>
> Entity ID or name from which to delete the role
>
> #### 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 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
>
> **intent** `string` *required*
>
> Intent ID or name to delete
>
> #### 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 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
>
> **entity** `string` *required*
>
> Entity ID or name from which to delete the synonym
>
> **keyword** `string` *required*
>
> Keyword from which to delete the synonym
>
> **synonym** `string` *required*
>
> Synonym to delete from the keyword
>
> #### 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 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
>
> **utterances** `array` *required*
>
> Array of utterance objects with text to delete. Must contain at least one utterance.
>
> #### 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] 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
>
> **n** `integer`
>
> Number of locales to return (default is 1)
>
> **q** `string` *required*
>
> Text to detect language from
>
> #### 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] 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
>
> **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 App Details
>
> **Slug:** `WIT_AI_GET_APP`
>
> Retrieve metadata and settings for a Wit.ai app by app ID, including its language, privacy and training status.
>
> #### Input Parameters
>
> **app\_id** `string` *required*
>
> ID of the Wit.ai app to retrieve
>
> **access\_token** `string`
>
> App-specific access token; if provided, overrides default Authorization header
>
> #### 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 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
>
> **entity** `string` *required*
>
> Entity ID or name 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 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
>
> **intent\_id** `string` *required*
>
> ID of the intent 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 Intents
>
> **Slug:** `WIT_AI_GET_INTENTS`
>
> List intents in a Wit.ai app, with optional limit and offset pagination.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of intents to return (default: 100, max: 200)
>
> **offset** `integer`
>
> Number of items to skip before starting to collect the result set (default: 0)
>
> #### 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] 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
>
> **n** `integer`
>
> Maximum number of outcomes to return (default is 1)
>
> **q** `string` *required*
>
> Text message to analyze for intent and entities
>
> **context** `string`
>
> JSON-stringified context object for conversation
>
> #### 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 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
>
> **trait\_id** `string` *required*
>
> Unique identifier of the trait 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 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
>
> **v** `string`
>
> API version to use, as a date (YYYYMMDD) or '20230215' for the current supported version. Defaults to latest stable if omitted.
>
> #### 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 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
>
> **voice** `string` *required*
>
> Voice name to retrieve details for (e.g., 'wit\$rebecca', 'wit\$charlie')
>
> #### 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 Wit.ai Apps
>
> **Slug:** `WIT_AI_LIST_APPS`
>
> List Wit.ai apps for the authenticated user with limit and offset pagination.
>
> #### Input Parameters
>
> **limit** `integer` *required*
>
> Maximum number of apps to return (required parameter)
>
> **offset** `integer`
>
> Number of apps to skip before starting to collect the result set
>
> #### 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 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
>
> **app** `string` *required*
>
> App ID to retrieve tags for
>
> #### 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 Entities
>
> **Slug:** `WIT_AI_LIST_ENTITIES`
>
> Tool to list all entities in a Wit.ai app. Use after authenticating to retrieve defined entities.
>
> #### 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 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
>
> **limit** `integer`
>
> Maximum number of utterances to return
>
> **offset** `integer`
>
> Number of utterances to skip before starting to collect the result set
>
> **traits** `array`
>
> Filter utterances by specific trait names
>
> **intents** `array`
>
> Filter utterances by specific intent names
>
> **entities** `array`
>
> Filter utterances by specific entity names
>
> #### 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 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
>
> **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 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
>
> **body** `object` *required*
>
> Fields and values to update on the app
>
> **app\_id** `string` *required*
>
> The unique identifier of the app to update
>
> **access\_token** `string`
>
> App-specific access token; if provided, overrides default Authorization header. Required when updating an app you created.
>
> #### 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
