List Tools

GET

/v2/tools

GET

/v2/tools

$ curl -G https://api.bctrl.ai/v2/tools \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d spaceId=spaceId

200Retrieved

1 {
2   "data": [
3     {
4       "createdAt": "2024-06-01T10:15:30Z",
5       "description": "Tool for processing incoming webhook events and triggering workflows.",
6       "execution": {
7         "auth": {
8           "type": "hmac",
9           "secretId": "hmac-secret-12345"
10         },
11         "timeoutMs": 30000,
12         "type": "webhook",
13         "url": "https://hooks.bctrl.ai/tools/webhook/1234abcd"
14       },
15       "id": "a3f1c9e2-4b7d-4f8a-9c2e-1d2f3b4a5c6d",
16       "inputSchema": {
17         "type": "object",
18         "properties": {
19           "event": {
20             "type": "string",
21             "description": "Name of the event to process"
22           },
23           "payload": {
24             "type": "object",
25             "description": "Event payload data"
26           }
27         },
28         "required": [
29           "event",
30           "payload"
31         ]
32       },
33       "name": "webhook_processor",
34       "outputSchema": {
35         "type": "object",
36         "properties": {
37           "status": {
38             "type": "string",
39             "enum": [
40               "success",
41               "failure"
42             ]
43           },
44           "message": {
45             "type": "string"
46           }
47         },
48         "required": [
49           "status"
50         ]
51       },
52       "spaceId": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70",
53       "status": "enabled",
54       "updatedAt": "2024-06-10T12:00:00Z",
55       "metadata": {
56         "version": "1.0",
57         "author": "dev-team"
58       }
59     }
60   ],
61   "nextCursor": null
62 }

List custom tools in a space using the simplified v2 response envelope.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Query parameters

spaceIdstringRequiredformat: "uuid"

limitintegerOptional<=200

Response

Default Response

datalist of objects

nextCursorstring or null