tools
tools

Execute a tool

Execute a tool with the specified parameters.

May return an approval required response if the tool needs approval.

post/api/tools/{tool_id}/execute

Request

  • Base URL: https://api.dialogbrain.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.dialogbrain.com/api/tools/{tool_id}/execute
  • Auth: none declared

Path parameters

tool_idstring required

Request body

tool_idstring required

ID of the tool to execute

paramsobject

Tool parameters

mode'draft' | 'auto' | 'supervised' | 'autonomous' | 'background_draft' | 'post_approval' | 'sandbox' | 'voice'

Execution modes for the AI agent.

skip_approvalboolean

Skip approval requirement (requires auto mode)

session_idstring nullable

Conversation session ID

thread_idstring nullable

Thread/channel ID for context

metadataobject

Additional metadata

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 5 revisions of this API.