> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Automation endpoint used by voice agents and trusted clients to execute workflow actions or retrieve evaluation results.

Automation endpoint used by voice agents and trusted clients to execute workflow actions or retrieve evaluation results.

### Response

`ToolsResponse`

<ResponseField name="count" type="integer" required>
  Total number of registered tools
</ResponseField>

<ResponseField name="tools" type="ToolEntry[]" required>
  List of available functions

  <Expandable title="ToolEntry">
    <ResponseField name="definition" type="ToolDefinition" required>
      Full function definition

      <Expandable title="ToolDefinition">
        <ResponseField name="description" type="string" required>
          Function description
        </ResponseField>

        <ResponseField name="name" type="string" required>
          Function name
        </ResponseField>

        <ResponseField name="parameters" type="object" required>
          JSON schema for parameters
        </ResponseField>

        <ResponseField name="type" type="string" required>
          Function type (always 'function')
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Function name
    </ResponseField>
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning                           |
| ----- | --------------------------------- |
| `200` | List available AI tools/functions |
| `401` | Unauthorized                      |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.voice.stateset.com/tools' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "count": 2,
    "tools": [
      {
        "definition": {
          "description": "Look up the current status of an order",
          "name": "get_order",
          "parameters": {
            "properties": {
              "order_id": {
                "description": "Order ID like ORD-12345",
                "type": "string"
              }
            },
            "required": [
              "order_id"
            ],
            "type": "object"
          },
          "type": "function"
        },
        "name": "get_order"
      },
      {
        "definition": {
          "description": "Transfer the current call to a human agent",
          "name": "escalate_call_to_human",
          "parameters": {
            "properties": {
              "reason": {
                "type": "string"
              },
              "target_number": {
                "description": "E.164 target number",
                "type": "string"
              }
            },
            "required": [
              "target_number"
            ],
            "type": "object"
          },
          "type": "function"
        },
        "name": "escalate_call_to_human"
      }
    ]
  }
  ```
</ResponseExample>