{
"webhook_url": "https://api.shop.com/v2/orders/status",
"timeout_seconds": 45
}
{
"success": true,
"message": "Tool updated successfully",
"data": {
"tool_id": "tool_a1b2c3d4e5f6",
"tool_name": "GetOrderStatus",
"webhook_url": "https://api.shop.com/v2/orders/status",
"timeout_seconds": 45,
"updated_at": "2024-01-20T15:00:00Z"
}
}
Tools
Update Tool
PUT
/
api
/
tools
/
{tool_id}
{
"webhook_url": "https://api.shop.com/v2/orders/status",
"timeout_seconds": 45
}
{
"success": true,
"message": "Tool updated successfully",
"data": {
"tool_id": "tool_a1b2c3d4e5f6",
"tool_name": "GetOrderStatus",
"webhook_url": "https://api.shop.com/v2/orders/status",
"timeout_seconds": 45,
"updated_at": "2024-01-20T15:00:00Z"
}
}
Update an existing tool configuration. Only provided fields will be updated.
Headers
string
required
Your API key for authentication.
string
required
The organization ID.
string
required
Must be
application/json.Path Parameters
string
required
The unique identifier of the tool.
Permissions
tools:update(admin, agent_manager)
Request Body
All fields are optional. Only provided fields will be updated.string
New name for the tool (pattern:
^[a-zA-Z0-9_]+$, 1-50 characters).string
New description (1-500 characters).
string
New webhook URL (1-500 characters).
string
New HTTP method:
GET, POST, PUT, PATCH, or DELETE.object
New headers (replaces existing).
array
New parameters (replaces existing).
integer
New timeout in seconds (1-60).
Response
boolean
Indicates if the update was successful.
string
Human-readable success message.
object
The updated tool object.
{
"webhook_url": "https://api.shop.com/v2/orders/status",
"timeout_seconds": 45
}
{
"success": true,
"message": "Tool updated successfully",
"data": {
"tool_id": "tool_a1b2c3d4e5f6",
"tool_name": "GetOrderStatus",
"webhook_url": "https://api.shop.com/v2/orders/status",
"timeout_seconds": 45,
"updated_at": "2024-01-20T15:00:00Z"
}
}
Errors
object
Tool not found.
object
Tool belongs to different organization.