Tools

List tool versions

GET

Path parameters

idstringRequired
Identifier for a tool. Formatted as a UUID.

Query parameters

page_numberintegerOptional
The page number of the results to return.
page_sizeintegerOptional
The maximum number of results to include per page.
restrict_to_most_recentbooleanOptional
Only include the most recent version of each tool in the list.

Response

This endpoint returns an object
page_number
integer
The page number of the returned results.
page_size
integer
The number of results returned per page.
tools_page
list of optional objects
List of tools returned for the specified page number and page size.
GET
1curl https://api.hume.ai/v0/evi/tools/00183a3f-79ba-413d-9f3b-609864268bea \
2 -H "X-Hume-Api-Key: <apiKey>"
200Retrieved
1{
2 "page_number": 0,
3 "page_size": 10,
4 "tools_page": [
5 {
6 "tool_type": "FUNCTION",
7 "id": "00183a3f-79ba-413d-9f3b-609864268bea",
8 "version": 1,
9 "version_type": "FIXED",
10 "name": "get_current_weather",
11 "created_on": 1715277014228,
12 "modified_on": 1715277602313,
13 "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\"] }",
14 "version_description": "Fetches current weather and uses celsius, fahrenheit, or kelvin based on location of user.",
15 "fallback_content": "Unable to fetch current weather.",
16 "description": "This tool is for getting the current weather."
17 }
18 ]
19}