Create Tool

Register a new custom tool for agents to use

POST /v2/tools

Request Body

{
  "name": "check_inventory",
  "type": "function",
  "description": "Check product inventory levels",
  "parameters": {
    "type": "object",
    "properties": {
      "product_id": {"type": "string", "description": "The product SKU"}
    },
    "required": ["product_id"]
  },
  "endpoint_url": "https://api.example.com/inventory",
  "method": "GET",
  "headers": {
    "Authorization": "Bearer {{API_KEY}}"
  }
}

Response

{
  "id": "tool_abc123",
  "name": "check_inventory",
  "type": "function",
  "description": "Check product inventory levels",
  "created_at": "2026-03-25T10:00:00Z"
}

On this page