1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createTool() {
11  const tool = await client.assistants.v1.tools.create({
12    name: "Schedule a Meeting",
13    type: "WEBHOOK",
14    description: "Use this to schedule a meeting",
15    enabled: true,
16    meta: {
17      url: "https://example.com",
18      method: "POST",
19      input_schema: "export type Data = { date: string }",
20    },
21  });
22
23  console.log(tool.accountSid);
24}
25
26createTool();

Output

1{
2  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "date_created": "2009-07-06T20:30:00Z",
4  "date_updated": "2009-07-06T20:30:00Z",
5  "description": "description",
6  "enabled": false,
7  "id": "aia_tool",
8  "meta": {},
9  "name": "name",
10  "requires_auth": false,
11  "type": "type",
12  "url": "url"
13}

List Tools

GET https://assistants.twilio.com/v1/Tools

Query parameters

Property nameTypeRequiredPIIDescription

AssistantIdstringOptional

Not PII

PageintegerOptional

Not PII

The page index. This value is simply for client state.

Minimum: 0

PageSizeintegerOptional

Not PII

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Minimum: 1Maximum: 1000

PageTokenstringOptional

Not PII

The page token. This is provided by the API.

List multiple Tools

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function listTools() {
11  const tools = await client.assistants.v1.tools.list({ limit: 20 });
12
13  tools.forEach((t) => console.log(t.accountSid));
14}
15
16listTools();

Output

1{
2  "meta": {
3    "first_page_url": "https://www.example.com",
4    "key": "key",
5    "next_page_url": "https://www.example.com",
6    "page": 42,
7    "page_size": 42,
8    "previous_page_url": "https://www.example.com",
9    "url": "https://www.example.com"
10  },
11  "tools": [
12    {
13      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
14      "description": "description",
15      "enabled": false,
16      "id": "aia_tool",
17      "meta": {},
18      "name": "name",
19      "requires_auth": false,
20      "type": "type",
21      "url": "url",
22      "date_created": "2009-07-06T20:30:00Z",
23      "date_updated": "2009-07-06T20:30:00Z"
24    }
25  ]
26}

Delete a Tool

DELETE https://assistants.twilio.com/v1/Tools/{id}

Path parameters

Property nameTypeRequiredPIIDescription

idstringrequired

Not PII

The tool ID.

Delete a Tool

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function deleteTool() {
11  await client.assistants.v1.tools("id").remove();
12}
13
14deleteTool();