Configs

Create config

POST

Request

This endpoint expects an object.
name
stringRequired
Name applied to all versions of a particular Config.
version_description
stringOptional
Description that is appended to a specific version of a Config.
prompt
objectOptional
A specific prompt identifier to be posted to the server
voice
objectOptional
A Voice specification posted to the server
language_model
objectOptional
A LanguageModel to be posted to the server
tools
list of optional objectsOptional
Tool specification for a Config.
builtin_tools
list of optional objectsOptional
Built-in tool specification for a Config.

Response

This endpoint returns an object
id
stringOptional
Identifier for a Config. Formatted as a UUID.
version
integerOptional
Version number for a Config. Version numbers should be integers. The combination of configId and version number is unique.
version_description
stringOptional
Description that is appended to a specific version of a Config.
name
stringOptional
Name applied to all versions of a particular Config.
created_on
integerOptional
The timestamp when the first version of this config was created.
modified_on
integerOptional
The timestamp when this version of the config was created.
prompt
objectOptional
A specific prompt version returned from the server
voice
objectOptional
A specific voice specification
language_model
objectOptional
A specific LanguageModel
tools
list of optional objectsOptional
List of user-defined tools associated with this config.
builtin_tools
list of optional objectsOptional
List of built-in tools associated with this config
POST
1curl -X POST https://api.hume.ai/v0/evi/configs \
2 -H "X-Hume-Api-Key: <apiKey>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "name": "name"
6}'
200Successful
1{
2 "id": "id",
3 "version": 1,
4 "version_description": "version_description",
5 "name": "name",
6 "created_on": 1,
7 "modified_on": 1,
8 "prompt": {
9 "id": "id",
10 "version": 1,
11 "version_type": "version_type",
12 "name": "name",
13 "created_on": 1,
14 "modified_on": 1,
15 "text": "text",
16 "version_description": "version_description"
17 },
18 "voice": {
19 "provider": "provider",
20 "name": "name"
21 },
22 "language_model": {
23 "model_provider": "model_provider",
24 "model_resource": "model_resource",
25 "temperature": 1.1
26 },
27 "tools": [
28 {
29 "tool_type": "tool_type",
30 "id": "id",
31 "version": 1,
32 "version_type": "version_type",
33 "name": "name",
34 "created_on": 1,
35 "modified_on": 1,
36 "parameters": "parameters",
37 "version_description": "version_description",
38 "fallback_content": "fallback_content",
39 "description": "description"
40 }
41 ],
42 "builtin_tools": [
43 {
44 "tool_type": "tool_type",
45 "name": "name",
46 "fallback_content": "fallback_content"
47 }
48 ]
49}