Create config version

POST

Updates a Config by creating a new version of the Config.

For more details on configuration options and how to configure EVI, see our configuration guide.

Path parameters

idstringRequired

Identifier for a Config. Formatted as a UUID.

Request

This endpoint expects an object.
evi_versionstringRequired

The version of the EVI used with this config.

version_descriptionstringOptional

An optional description of the Config version.

promptobjectOptional

Identifies which prompt to use in a a config OR how to create a new prompt to use in the config

voiceobjectOptional

A voice specification associated with this Config version.

language_modelobjectOptional

The supplemental language model associated with this Config version.

This model is used to generate longer, more detailed responses from EVI. Choosing an appropriate supplemental language model for your use case is crucial for generating fast, high-quality responses from EVI.

ellm_modelobjectOptional

The eLLM setup associated with this Config version.

Hume’s eLLM (empathic Large Language Model) is a multimodal language model that takes into account both expression measures and language. The eLLM generates short, empathic language responses and guides text-to-speech (TTS) prosody.

toolslist of optional objectsOptional

List of user-defined tools associated with this Config version.

builtin_toolslist of optional objectsOptional

List of built-in tools associated with this Config version.

event_messagesobjectOptional

Collection of event messages returned by the server.

Event messages are sent by the server when specific events occur during a chat session. These messages are used to configure behaviors for EVI, such as controlling how EVI starts a new conversation.

timeoutsobjectOptional

Collection of timeout specifications returned by the server.

Timeouts are sent by the server when specific time-based events occur during a chat session. These specifications set the inactivity timeout and the maximum duration an EVI WebSocket connection can stay open before it is automatically disconnected.

Response

Created

idstringOptional

Identifier for a Config. Formatted as a UUID.

versionintegerOptional

Version number for a Config.

Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed.

Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number.

evi_versionstringOptional

Specifies the EVI version to use. Use "1" for version 1, or "2" for the latest enhanced version. For a detailed comparison of the two versions, refer to our guide.

version_descriptionstringOptional

An optional description of the Config version.

namestringOptional

Name applied to all versions of a particular Config.

created_onlongOptionalDefaults to 0

Time at which the Config was created. Measured in seconds since the Unix epoch.

modified_onlongOptionalDefaults to 0

Time at which the Config was last modified. Measured in seconds since the Unix epoch.

promptobjectOptional

A Prompt associated with this Config.

voiceobjectOptional

A voice specification associated with this Config.

language_modelobjectOptional

The supplemental language model associated with this Config.

This model is used to generate longer, more detailed responses from EVI. Choosing an appropriate supplemental language model for your use case is crucial for generating fast, high-quality responses from EVI.

ellm_modelobjectOptional

The eLLM setup associated with this Config.

Hume’s eLLM (empathic Large Language Model) is a multimodal language model that takes into account both expression measures and language. The eLLM generates short, empathic language responses and guides text-to-speech (TTS) prosody.

toolslist of optional objectsOptional

List of user-defined tools associated with this Config.

builtin_toolslist of optional objectsOptional

List of built-in tools associated with this Config.

event_messagesobjectOptional

Collection of event messages returned by the server.

Event messages are sent by the server when specific events occur during a chat session. These messages are used to configure behaviors for EVI, such as controlling how EVI starts a new conversation.

timeoutsobjectOptional

Collection of timeout specifications returned by the server.

Timeouts are sent by the server when specific time-based events occur during a chat session. These specifications set the inactivity timeout and the maximum duration an EVI WebSocket connection can stay open before it is automatically disconnected.