Get tool version | Hume API

1 curl https://api.hume.ai/v0/evi/tools/00183a3f-79ba-413d-9f3b-609864268bea/version/1 \ 2 -H "X-Hume-Api-Key: <apiKey>"

1 { 2 "created_on": 1715277014228, 3 "id": "00183a3f-79ba-413d-9f3b-609864268bea", 4 "modified_on": 1715277602313, 5 "name": "string", 6 "parameters": "{ \"type\": \"object\", \"properties\": { \"location\": { \"type\": \"string\", \"description\": \"The city and state, e.g. San Francisco, CA\" }, \"format\": { \"type\": \"string\", \"enum\": [\"celsius\", \"fahrenheit\", \"kelvin\"], \"description\": \"The temperature unit to use. Infer this from the users location.\" } }, \"required\": [\"location\", \"format\"] }", 7 "tool_type": "FUNCTION", 8 "version": 1, 9 "version_type": "FIXED", 10 "description": "This tool is for getting the current weather.", 11 "fallback_content": "Unable to fetch current weather.", 12 "version_description": "Fetches current weather and uses celsius, fahrenheit, or kelvin based on location of user." 13 }

Authentication

X-Hume-Api-Keystring

API Key authentication via header

Path parameters

idstringRequiredformat: "uuid"

Identifier for a tool. Formatted as a UUID.

versionintegerRequired

Version number for a tool. Version numbers should be integers.

Response

Success

created_onlong

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

idstring

Identifier for a Tool. Formatted as a UUID.

modified_onlong

The timestamp when this version of the tool was created.

namestring

Name applied to all versions of a particular Tool.

parametersstring

Stringified JSON defining the parameters used by this version of the Tool.

tool_typeenum

Allowed values:

versioninteger

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

version_typeenum

Allowed values:

descriptionstring or null

Text describing what the tool does.

fallback_contentstring or null

Text to use if the tool fails to generate content.

version_descriptionstring or null

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