ROroarkhq
Tool

Update a tool

Changed on

Replaces the tool: its name, scope, inputs, description, grading hints and runtime. A field left out is cleared, so omitting agentId makes the tool project-wide. A change declares a new version; agent versions pinned to an older one keep it.

put/v1/tool/{toolId}

Request

  • Base URL
    https://api.roark.ai
  • URL
    https://api.roark.ai/v1/tool/{toolId}
  • Auth
    HTTP bearer

Path parameters

toolIdstring uuid required

Request body

namestring required
descriptionstring required

When the agent should use the tool

agentIdstring uuid nullable
invocationCriteriastring nullable
expectedResultstring nullable

Example request

{
  "name": "book_appointment",
  "inputs": [
    {
      "name": "date"
    }
  ],
  "runtime": {
    "request": {
      "headers": [
        {
          "name": "X-Api-Version",
          "value": "2026-10-01"
        }
      ]
    }
  }
}

Response

The tool

Example response

{
  "data": {
    "name": "book_appointment",
    "inputs": [
      {
        "name": "date",
        "description": "ISO date"
      }
    ],
    "runtime": {
      "request": {
        "url": "https://api.example.com/bookings",
        "headers": [
          {
            "name": "X-Api-Version",
            "value": "2026-10-01"
          }
        ]
      }
    }
  }
}

Changes