ROroarkhq
Tool

List tools

Changed on

The project's tools and the built-in ones, each with its latest version: inputs, description and, for a tool a hosted agent runs, its request. Attach one to an agent draft by id.

get/v1/tool

Request

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

Query parameters

agentIdstring uuid

Only tools scoped to this agent

includeBuiltIn'true' | 'false'

Include the built-in tools (default true)

Response

The tools

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