Create a new tool

Creates a new tool with the specified configurations and returns the tool details including the generated tool ID.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The id of the application to retrieve tools from.

Body Params
string
enum
required

The code of the tool type.

Allowed:
integer
required

ID of the catalog item this tool uses (e.g., references 'Contact Center', 'Dialogflow').

config
object

Configuration settings for the general tool, stored as JSON. This can include a 'custom output' key with a string value. For specific catalog tools like 'Contact Center' or 'Dialogflow' (identified by catalog_id), this 'config' field is mandatory and must contain a 'custom output' key with a non-empty string value. This validation is performed by the service.

string
required

Name of the tool configuration.

string

Description of the tool configuration.

boolean

Flag indicating if human review is required for this tool's output.

string | null

Message to display if human review is triggered.

string | null

Keyword to approve the agent actions.

argsSchema
object | null

JSON schema for the tool's arguments, defining expected input parameters.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json