Skip to contentSkip to navigationSkip to topbar
Twilio Docs
On this page

Tools Resource

Create and configure Tools that an AI Assistant can use.

Tool Properties

tool-properties page anchor
Property nameTypeRequiredDescriptionChild properties
accountSidSID<AC>

Optional

Not PII

The SID of the Account that created the Tool resource.

Pattern: ^AC[0-9a-fA-F]{32}$Min length: 34Max length: 34
descriptionstring
required
Not PII

The description of the tool.

enabledboolean
required
Not PII

True if the tool is enabled.

idstring
required
Not PII

The tool ID.

Pattern: ^aia_tool_*$
metaobject
required
Not PII

The metadata related to method, url, input_schema to used with the Tool.

namestring
required
Not PII

The name of the tool.

requiresAuthboolean
required
Not PII

The authentication requirement for the tool.

typestring
required
Not PII

The type of the tool. ('WEBHOOK')

urlstring

Optional

Not PII

The url of the tool resource.

dateCreatedstring<date-time>
required
Not PII

The date and time in GMT when the Tool was created specified in ISO 8601(link takes you to an external page) format.

dateUpdatedstring<date-time>
required
Not PII

The date and time in GMT when the Tool was last updated specified in ISO 8601(link takes you to an external page) format.

Create a Tool

create-a-tool page anchor

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

Request body parameters

request-body-parameters page anchor
Encoding type:application/json
Schema
Property nameTypeRequiredDescriptionChild properties
assistantIdstring

Optional

Not PII

The Assistant ID.

Pattern: ^aia_asst_*$
descriptionstring

Optional

Not PII

The description of the tool.

enabledboolean
required
Not PII

True if the tool is enabled.

metaobject

Optional

Not PII

The metadata related to method, url, input_schema to used with the Tool.

namestring
required
Not PII

The name of the tool.

policyobject

Optional

Not PII

The policy associated with the tool.

typestring
required
Not PII

The description of the tool.

Create a ToolLink to code sample: Create a Tool
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const 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

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async 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


26
createTool();

Response

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": "Miss Christine Morgan",

10
  "requires_auth": false,

11
  "type": "type",

12
  "url": "https://www.example.com"

13
}

Get a Tool

get-a-tool page anchor

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

Path parameters

path-parameters page anchor
Property nameTypeRequiredPIIDescription
idstring
required
Not PII
Get a ToolLink to code sample: Get a Tool
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const 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

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function fetchTool() {

11
  const tool = await client.assistants.v1.tools("aia_tool").fetch();

12


13
  console.log(tool.accountSid);

14
}

15


16
fetchTool();

Response

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": "Miss Christine Morgan",

10
  "policies": [

11
    {

12
      "id": "aia_plcy",

13
      "name": "name",

14
      "description": "description",

15
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

16
      "user_sid": "USaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

17
      "type": "type",

18
      "policy_details": {},

19
      "date_created": "2009-07-06T20:30:00Z",

20
      "date_updated": "2009-07-06T20:30:00Z"

21
    }

22
  ],

23
  "requires_auth": false,

24
  "type": "type",

25
  "url": "https://www.example.com"

26
}

List Tools

list-tools page anchor

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

Query parameters

query-parameters page anchor
Property nameTypeRequiredPIIDescription
assistantIdstring

Optional

Not PII
pageinteger

Optional

Not PII

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

Minimum: 0
pageSizeinteger

Optional

Not PII

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

Minimum: 1Maximum: 1000
pageTokenstring

Optional

Not PII

The page token. This is provided by the API.

List multiple ToolsLink to code sample: List multiple Tools
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const 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

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function listTools() {

11
  const tools = await client.assistants.v1.tools.list({ limit: 20 });

12


13
  tools.forEach((t) => console.log(t.accountSid));

14
}

15


16
listTools();

Response

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": "https://www.example.com",

22
      "date_created": "2009-07-06T20:30:00Z",

23
      "date_updated": "2009-07-06T20:30:00Z"

24
    }

25
  ]

26
}

Delete a Tool

delete-a-tool page anchor

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

Path parameters

path-parameters-1 page anchor
Property nameTypeRequiredPIIDescription
idstring
required
Not PII

The tool ID.

Delete a ToolLink to code sample: Delete a Tool
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const 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

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function deleteTool() {

11
  await client.assistants.v1.tools("aia_tool").remove();

12
}

13


14
deleteTool();