Get System Tools

Retrieve all available system tools that can be configured for agents.

HTTP Request

$ GET https://app.resemble.ai/api/v2/agents/system_tools

Example Request

$ curl --request GET "https://app.resemble.ai/api/v2/agents/system_tools" \
>   -H "Authorization: Bearer YOUR_API_TOKEN" \
>   -H "Content-Type: application/json"

Response

1 {
2   "success": true,
3   "items": [
4     {
5       "identifier": "end_call",
6       "description": "Use this tool to end the current phone call immediately.",
7       "default_config": {
8         "parameters": {},
9         "assignments": [],
10         "disable_interruptions": false,
11         "force_pre_tool_speech": false
12       },
13       "default_active": true
14     },
15     {
16       "identifier": "transfer_to_number",
17       "description": "Transfers the current call to another phone number.",
18       "default_config": {
19         "parameters": {},
20         "assignments": [],
21         "disable_interruptions": false,
22         "force_pre_tool_speech": false
23       },
24       "default_active": false
25     },
26     {
27       "identifier": "voicemail_detection",
28       "description": "Detects if the call has reached voicemail.",
29       "default_config": {
30         "parameters": {},
31         "assignments": [],
32         "disable_interruptions": false,
33         "force_pre_tool_speech": false
34       },
35       "default_active": false
36     }
37   ]
38 }

Response Body

Attribute	Type	Description
success	boolean	Indicates if the request was successful
items	array	Array of system tool objects

System Tool Object

Attribute	Type	Description
identifier	string	Unique identifier for the system tool
description	string	Description of what the tool does (used by LLM)
default_config	object	Default configuration for the tool
default_active	boolean	Whether the tool is enabled by default

Default Config Object

Attribute	Type	Description
parameters	object	Tool parameters (empty for most system tools)
assignments	array	Variable assignments (empty for most system tools)
disable_interruptions	boolean	Whether to prevent user interruptions during tool use
force_pre_tool_speech	boolean	Whether to force agent to speak before using tool

Available System Tools

end_call

Ends the current phone call immediately.

Default Active: true
Use Case: Agent determines conversation is complete
Interruptions: Disabled by default to ensure clean call termination

transfer_to_number

Transfers the current call to another phone number.

Default Active: false
Use Case: Agent needs to escalate to human support or different department
Interruptions: Disabled during transfer to prevent confusion

voicemail_detection

Detects if the call has reached voicemail instead of a person.

Default Active: false
Use Case: Outbound calling scenarios where detecting voicemail matters
Interruptions: N/A (detection happens automatically)

Configuring System Tools

System tools are automatically created for each agent. You can configure them during agent creation or update:

1 {
2   "system_tools": {
3     "end_call": {
4       "active": true,
5       "disable_interruptions": false,
6       "force_pre_tool_speech": false
7     },
8     "transfer_to_number": {
9       "active": true,
10       "disable_interruptions": true,
11       "force_pre_tool_speech": true
12     },
13     "voicemail_detection": {
14       "active": true,
15       "disable_interruptions": false,
16       "force_pre_tool_speech": false
17     }
18   }
19 }

Limitations

System tools cannot be created manually (they are platform-provided)
System tools cannot be deleted (they can only be disabled via active: false)
System tool identifiers and core functionality cannot be modified
Only configuration flags (active, disable_interruptions, force_pre_tool_speech) can be updated

HTTP Request

$ GET https://app.resemble.ai/api/v2/agents/system_tools

Example Request

$ curl --request GET "https://app.resemble.ai/api/v2/agents/system_tools" \
>   -H "Authorization: Bearer YOUR_API_TOKEN" \
>   -H "Content-Type: application/json"

Response

1 {
2   "success": true,
3   "items": [
4     {
5       "identifier": "end_call",
6       "description": "Use this tool to end the current phone call immediately.",
7       "default_config": {
8         "parameters": {},
9         "assignments": [],
10         "disable_interruptions": false,
11         "force_pre_tool_speech": false
12       },
13       "default_active": true
14     },
15     {
16       "identifier": "transfer_to_number",
17       "description": "Transfers the current call to another phone number.",
18       "default_config": {
19         "parameters": {},
20         "assignments": [],
21         "disable_interruptions": false,
22         "force_pre_tool_speech": false
23       },
24       "default_active": false
25     },
26     {
27       "identifier": "voicemail_detection",
28       "description": "Detects if the call has reached voicemail.",
29       "default_config": {
30         "parameters": {},
31         "assignments": [],
32         "disable_interruptions": false,
33         "force_pre_tool_speech": false
34       },
35       "default_active": false
36     }
37   ]
38 }

Response Body

Attribute	Type	Description
success	boolean	Indicates if the request was successful
items	array	Array of system tool objects

System Tool Object

Attribute	Type	Description
identifier	string	Unique identifier for the system tool
description	string	Description of what the tool does (used by LLM)
default_config	object	Default configuration for the tool
default_active	boolean	Whether the tool is enabled by default

Default Config Object

Attribute	Type	Description
parameters	object	Tool parameters (empty for most system tools)
assignments	array	Variable assignments (empty for most system tools)
disable_interruptions	boolean	Whether to prevent user interruptions during tool use
force_pre_tool_speech	boolean	Whether to force agent to speak before using tool

Available System Tools

end_call

Ends the current phone call immediately.

Default Active: true
Use Case: Agent determines conversation is complete
Interruptions: Disabled by default to ensure clean call termination

transfer_to_number

Transfers the current call to another phone number.

Default Active: false
Use Case: Agent needs to escalate to human support or different department
Interruptions: Disabled during transfer to prevent confusion

voicemail_detection

Detects if the call has reached voicemail instead of a person.

Default Active: false
Use Case: Outbound calling scenarios where detecting voicemail matters
Interruptions: N/A (detection happens automatically)

Configuring System Tools

System tools are automatically created for each agent. You can configure them during agent creation or update:

1 {
2   "system_tools": {
3     "end_call": {
4       "active": true,
5       "disable_interruptions": false,
6       "force_pre_tool_speech": false
7     },
8     "transfer_to_number": {
9       "active": true,
10       "disable_interruptions": true,
11       "force_pre_tool_speech": true
12     },
13     "voicemail_detection": {
14       "active": true,
15       "disable_interruptions": false,
16       "force_pre_tool_speech": false
17     }
18   }
19 }

Limitations

System tools cannot be created manually (they are platform-provided)
System tools cannot be deleted (they can only be disabled via active: false)
System tool identifiers and core functionality cannot be modified
Only configuration flags (active, disable_interruptions, force_pre_tool_speech) can be updated

Get System Tools

Get System Tools

HTTP Request

Example Request

Response

Response Body

System Tool Object

Default Config Object

Available System Tools

end_call

transfer_to_number

voicemail_detection

Configuring System Tools

Limitations

See Also

HTTP Request

Example Request

Response

Response Body

System Tool Object

Default Config Object

Available System Tools

end_call

transfer_to_number

voicemail_detection

Configuring System Tools

Limitations

See Also

$	curl --request GET "https://app.resemble.ai/api/v2/agents/system_tools" \
>	-H "Authorization: Bearer YOUR_API_TOKEN" \
>	-H "Content-Type: application/json"

1	{
2	"success": true,
3	"items": [
4	{
5	"identifier": "end_call",
6	"description": "Use this tool to end the current phone call immediately.",
7	"default_config": {
8	"parameters": {},
9	"assignments": [],
10	"disable_interruptions": false,
11	"force_pre_tool_speech": false
12	},
13	"default_active": true
14	},
15	{
16	"identifier": "transfer_to_number",
17	"description": "Transfers the current call to another phone number.",
18	"default_config": {
19	"parameters": {},
20	"assignments": [],
21	"disable_interruptions": false,
22	"force_pre_tool_speech": false
23	},
24	"default_active": false
25	},
26	{
27	"identifier": "voicemail_detection",
28	"description": "Detects if the call has reached voicemail.",
29	"default_config": {
30	"parameters": {},
31	"assignments": [],
32	"disable_interruptions": false,
33	"force_pre_tool_speech": false
34	},
35	"default_active": false
36	}
37	]
38	}

1	{
2	"system_tools": {
3	"end_call": {
4	"active": true,
5	"disable_interruptions": false,
6	"force_pre_tool_speech": false
7	},
8	"transfer_to_number": {
9	"active": true,
10	"disable_interruptions": true,
11	"force_pre_tool_speech": true
12	},
13	"voicemail_detection": {
14	"active": true,
15	"disable_interruptions": false,
16	"force_pre_tool_speech": false
17	}
18	}
19	}