List Tools

GET

/v1/tools

GET

/v1/tools

$ curl https://api.bctrl.ai/v1/tools \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "data": [
3     {
4       "type": "webhook",
5       "createdAt": "2024-05-20T10:15:30Z",
6       "description": "Webhook tool for processing incoming payment notifications.",
7       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
8       "inputSchema": {
9         "type": "object",
10         "properties": {
11           "paymentId": {
12             "type": "string"
13           },
14           "amount": {
15             "type": "number"
16           }
17         },
18         "required": [
19           "paymentId",
20           "amount"
21         ]
22       },
23       "name": "payment_webhook",
24       "outputSchema": {
25         "type": "object",
26         "properties": {
27           "status": {
28             "type": "string"
29           },
30           "processedAt": {
31             "type": "string",
32             "format": "date-time"
33           }
34         },
35         "required": [
36           "status",
37           "processedAt"
38         ]
39       },
40       "spaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
41       "status": "enabled",
42       "updatedAt": "2024-05-21T08:45:00Z",
43       "url": "https://hooks.bctrl.ai/payment",
44       "authSecretId": "sec_9f8e7d6c5b4a3210",
45       "metadata": {
46         "version": "1.2.0",
47         "owner": "finance-team"
48       },
49       "timeoutMs": 30000
50     }
51   ],
52   "nextCursor": "eyJpZCI6IjNmYTg1ZjY0LTU3MTctNDU2Mi1iM2ZjLTJjOTYzZjY2YWZhNiIsImFjdGl2ZSI6dHJ1ZX0"
53 }

List organization custom tools using a space as the authorization context.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Query parameters

spaceIdstring or "default"Optional

cursorstringOptional>=1 character

limitintegerOptional<=200Defaults to 50

Response

datalist of objects

nextCursorstring or null

Errors

401

Unauthorized Error

403

Forbidden Error