main

Create a new tool.

Args: request: The tool creation request

Returns: The created tool

post/api/v1/tools/

Request

  • Base URL
    https://app.dograh.com
  • URL
    https://app.dograh.com/api/v1/tools/
  • Auth
    none declared

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

namestring required

Display name for the tool.

descriptionstring nullable

Description shown to the agent when deciding whether to call it.

category'http_api' | 'end_call' | 'transfer_call' | 'transfer_agent' | 'calculator' | 'native' | 'integration' | 'mcp'

Tool category. Must match definition.type.

iconstring nullable

Lucide icon identifier.

icon_colorstring nullable

Hex color for the tool icon.

Response

Successful Response

idinteger required
tool_uuidstring required
namestring required
descriptionstring nullable required
categorystring required
iconstring nullable required
icon_colorstring nullable required
statusstring required
definitionobject required
created_atstring date-time required
updated_atstring date-time nullable required

Changes