List Tools

GET

/v1/spaces/:id/tools

GET

/v1/spaces/:id/tools

1 curl https://api.bctrl.ai/v1/spaces/id/tools \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json"

200Retrieved

1 {
2   "tools": [
3     {
4       "createdAt": "2024-05-20T10:15:30Z",
5       "description": "Webhook to trigger deployment pipeline on code push events.",
6       "enabled": true,
7       "execution": {
8         "auth": {
9           "type": "hmac",
10           "secretId": "deploy-webhook-secret-01"
11         },
12         "timeoutMs": 30000,
13         "type": "webhook",
14         "url": "https://ci.example.com/hooks/deploy"
15       },
16       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
17       "inputSchema": {
18         "branch": {
19           "type": "string",
20           "description": "Git branch to deploy"
21         },
22         "commitId": {
23           "type": "string",
24           "description": "Commit SHA triggering the deployment"
25         }
26       },
27       "name": "deploy_pipeline",
28       "outputSchema": {
29         "status": {
30           "type": "string",
31           "enum": [
32             "success",
33             "failure"
34           ]
35         },
36         "message": {
37           "type": "string"
38         }
39       },
40       "spaceId": "7e57d004-2b97-0e7a-b45f-5387367791cd",
41       "updatedAt": "2024-05-22T08:45:00Z",
42       "metadata": {
43         "owner": "devops-team",
44         "version": "1.2.0"
45       }
46     }
47   ]
48 }

List the custom tools available in a space. Use this to choose which callable capabilities should be added to toolsets for agent invocations.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

idstringRequired

Query parameters

limitintegerOptional<=200

Response

Default Response

toolslist of objects