Get tool

GET

https://app.lumenia.net/api/v1/tools/:toolId

GET

/api/v1/tools/:toolId

$ curl https://app.lumenia.net/api/v1/tools/toolId \
>      -H "Authorization: Bearer <API_KEY>"

1 {
2   "tool": {
3     "id": "b2c3d4e5-6f70-4a1b-8c2d-3e4f5a6b7c8d",
4     "name": "ask_lumenone",
5     "description": "Query the knowledge base",
6     "method": "POST",
7     "url": "https://app.lumenia.tech/api/v1/vapi/ask_lumenone",
8     "headers": {
9       "properties": {
10         "Authorization": {
11           "type": "string",
12           "value": "••••••"
13         }
14       },
15       "type": "object"
16     },
17     "requestSchema": {
18       "properties": {
19         "query": {
20           "description": "The caller question",
21           "type": "string"
22         }
23       },
24       "required": [
25         "query"
26       ],
27       "type": "object"
28     },
29     "responseSchema": {
30       "properties": {
31         "answer": {
32           "description": "Answer to read back to the caller",
33           "type": "string"
34         }
35       },
36       "required": [
37         "answer"
38       ],
39       "type": "object"
40     },
41     "aliases": [
42       {
43         "key": "kb_answer",
44         "value": "{{ $.answer }}"
45       }
46     ],
47     "createdAt": "2026-06-15T05:24:00.000Z",
48     "updatedAt": "2026-06-15T05:24:00.000Z"
49   }
50 }

Return a tool by ID.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <API_KEY>, where API_KEY is your API key.

Path parameters

toolIdstringRequired

Tool to retrieve.

Query parameters

unmaskstringOptional

Comma-separated header names to reveal. Other header values remain masked.

Response

The requested tool.

toolobject

The tool.

Errors

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors