Tools

List tools

GET

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 -G https://api.hume.ai/v0/evi/tools \
2 -H "X-Hume-Api-Key: <apiKey>" \
3 -d page_number=0 \
4 -d page_size=2
200Retrieved
1{
2 "page_number": 0,
3 "page_size": 2,
4 "tools_page": [
5 {
6 "tool_type": "FUNCTION",
7 "id": "d20827af-5d8d-4f66-b6b9-ce2e3e1ea2b2",
8 "version": 0,
9 "version_type": "FIXED",
10 "name": "get_current_location",
11 "created_on": 1715267200693,
12 "modified_on": 1715267200693,
13 "parameters": "{ \"type\": \"object\", \"properties\": { \"location\": { \"type\": \"string\", \"description\": \"The city and state, e.g. San Francisco, CA\" }}, \"required\": [\"location\"] }",
14 "version_description": "Fetches user's current location.",
15 "fallback_content": "Unable to fetch location.",
16 "description": "Fetches user's current location."
17 },
18 {
19 "tool_type": "FUNCTION",
20 "id": "4442f3ea-9038-40e3-a2ce-1522b7de770f",
21 "version": 0,
22 "version_type": "FIXED",
23 "name": "get_current_weather",
24 "created_on": 1715266126705,
25 "modified_on": 1715266126705,
26 "parameters": "{ \"type\": \"object\", \"properties\": { \"location\": { \"type\": \"string\", \"description\": \"The city and state, e.g. San Francisco, CA\" }, \"format\": { \"type\": \"string\", \"enum\": [\"celsius\", \"fahrenheit\"], \"description\": \"The temperature unit to use. Infer this from the users location.\" } }, \"required\": [\"location\", \"format\"] }",
27 "version_description": "Fetches current weather and uses celsius or fahrenheit based on location of user.",
28 "fallback_content": "Unable to fetch location.",
29 "description": "Fetches current weather and uses celsius or fahrenheit based on location of user."
30 }
31 ]
32}