List tools

GET

https://api.smallest.ai/atoms/v1/tool

GET

/atoms/v1/tool

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/tool"
4 
5 headers = {"Authorization": "Bearer <token>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

1 {
2   "status": true,
3   "data": [
4     {
5       "_id": "6a86c89eb3073ea15c328ce0",
6       "toolId": "tool_ab12cd34ef56gh78ij90kl12",
7       "organizationId": "6a5f9c9fcf10167aad404c40",
8       "type": "api_call",
9       "definition": {
10         "type": "api_call",
11         "name": "get_order_status",
12         "description": "Look up a customer's order by id and read back its status.",
13         "enabled": true,
14         "url": "https://api.example.com/orders",
15         "method": "GET",
16         "timeout": 5000,
17         "headers": {
18           "Authorization": "Bearer TOKEN",
19           "Content-Type": "application/json"
20         },
21         "headersArray": [
22           {
23             "key": "Authorization",
24             "value": "Bearer TOKEN"
25           }
26         ],
27         "queryParams": [
28           {
29             "key": "id",
30             "value": "{{order_id}}"
31           }
32         ],
33         "requestBody": "{\"customer_id\": \"{{customer_id}}\"}",
34         "llmParameters": [
35           {
36             "name": "string",
37             "description": "string",
38             "type": "text",
39             "values": [
40               "string"
41             ],
42             "required": false
43           }
44         ],
45         "responseVariables": [
46           {
47             "variableName": "orderStatus",
48             "jsonPath": "$.data.status"
49           }
50         ],
51         "auth": {
52           "type": "none",
53           "token": "ORDER_API_TOKEN",
54           "name": "X-API-Key",
55           "location": "header",
56           "value": "SEARCH_API_KEY",
57           "username": "string",
58           "password": "string"
59         },
60         "timeoutMs": 1000,
61         "expectsResponse": true,
62         "fillerPhrases": [
63           "Let me check that for you",
64           "One moment please"
65         ]
66       },
67       "createdAt": "2024-01-15T09:30:00Z",
68       "updatedAt": "2024-01-15T09:30:00Z"
69     }
70   ]
71 }

List the organization's tools from the Tools library.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Response

The org's tools.

statusbooleanOptional

datalist of objectsOptional

Errors

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error