Update config description

Updates the description of a Config.

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

Path parameters

idstringRequiredformat: "uuid"

Identifier for a Config. Formatted as a UUID.

versionintegerRequired

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.

Headers

X-Hume-Api-KeystringRequired

Request

This endpoint expects an object.

version_descriptionstringOptional

An optional description of the Config version.

Response

Success

idstring or null

Identifier for a Config. Formatted as a UUID.

versioninteger or null

Version number for a Config. Version numbers should be integers. The combination of configId and version number is unique.

evi_versionstring or null

The version of the EVI used with this config.

version_descriptionstring or null

Description that is appended to a specific version of a Config.

namestring or null

Name applied to all versions of a particular Config.

created_onlong or null

The timestamp when the first version of this config was created.

modified_onlong or null

The timestamp when this version of the config was created.

promptobject or null

A specific prompt version returned from the server

voiceany or null

language_modelobject or null

A specific LanguageModel

ellm_modelobject or null

A specific eLLM Model configuration

toolslist of objects or null

List of user-defined tools associated with this config.

builtin_toolslist of objects or null

List of built-in tools associated with this config

event_messagesobject or null

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.

timeoutsobject or null

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.

nudgesobject or null

A specific nudge configuration returned from the server

webhookslist of objects or null

Map of webhooks associated with this config.

1	from hume import HumeClient
2
3	client = HumeClient(
4	api_key="YOUR_API_KEY",
5	)
6	client.empathic_voice.configs.update_config_description(
7	id="1b60e1a0-cc59-424a-8d2c-189d354db3f3",
8	version=1,
9	version_description="This is an updated version_description.",
10	)

1	{
2	"id": "1b60e1a0-cc59-424a-8d2c-189d354db3f3",
3	"version": 1,
4	"evi_version": "3",
5	"version_description": "This is an updated version_description.",
6	"name": "Weather Assistant Config",
7	"created_on": 1715275452390,
8	"modified_on": 1715275452390,
9	"prompt": {
10	"id": "af699d45-2985-42cc-91b9-af9e5da3bac5",
11	"version": 0,
12	"version_type": "FIXED",
13	"name": "Weather Assistant Prompt",
14	"created_on": 1715267200693,
15	"modified_on": 1715267200693,
16	"text": "<role>You are an AI weather assistant providing users with accurate and up-to-date weather information. Respond to user queries concisely and clearly. Use simple language and avoid technical jargon. Provide temperature, precipitation, wind conditions, and any weather alerts. Include helpful tips if severe weather is expected.</role>",
17	"version_description": ""
18	},
19	"voice": {
20	"provider": "HUME_AI",
21	"name": "Ava Song",
22	"id": "5bb7de05-c8fe-426a-8fcc-ba4fc4ce9f9c"
23	},
24	"language_model": {
25	"model_provider": "ANTHROPIC",
26	"model_resource": "claude-3-7-sonnet-latest",
27	"temperature": 1
28	},
29	"ellm_model": {
30	"allow_short_responses": false
31	},
32	"tools": [],
33	"builtin_tools": [],
34	"event_messages": {
35	"on_new_chat": {
36	"enabled": false,
37	"text": ""
38	},
39	"on_inactivity_timeout": {
40	"enabled": false,
41	"text": ""
42	},
43	"on_max_duration_timeout": {
44	"enabled": false,
45	"text": ""
46	}
47	},
48	"timeouts": {
49	"inactivity": {
50	"enabled": true,
51	"duration_secs": 600
52	},
53	"max_duration": {
54	"enabled": true,
55	"duration_secs": 1800
56	}
57	}
58	}