Skip to main content
GET /workflows/:id/tools List the custom HTTP tools an agent can call — its own hand-rolled functions on top of the built-in ones.

​
Path Parameters

ParameterTypeRequiredDescription
idstring (uuid)YesAgent ID

​
Responses

​
200 — Successful response

{
  "success": true,
  "tools": [
    {
      "id": "9a1b2c3d-0000-4000-8000-000000000001",
      "name": "check_availability",
      "description": "Checks open slots on the sales calendar for a given day",
      "method": "GET",
      "url": "https://api.acme.com/availability",
      "is_active": true,
      "available_in_statuses": ["qualified"],
      "auto_run_on_entry": false,
      "call_once": false,
      "sort_order": 0
    }
  ]
}

​
Response Fields — WorkflowTool

FieldTypeDescription
idstring (uuid)Tool identifier
namestringsnake_case name the agent references when calling the tool
descriptionstringTells the agent what the tool does and when to use it
methodstringHTTP method the tool calls: GET, POST, PUT, PATCH, or DELETE
urlstringEndpoint the tool calls
is_activebooleanWhether the agent can currently call this tool
available_in_statusesstring[] | nullFunnel status keys where this tool is offered. null means every status
auto_run_on_entrybooleanWhether the tool runs automatically when a lead enters an eligible status
call_oncebooleanWhether the tool can only be called once per lead
sort_orderintegerDisplay order

​
401 — Authentication error

See Authentication.

​
404 — Not found

{
  "error": "Not found",
  "message": "Workflow not found"
}

​
500 — Internal server error

Last modified on July 10, 2026