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

# List Tools

> List all available tool definitions (system + skill tools).

Returns all tools available to the authenticated user, combining system registry tools with tools from installed skills.

## Authentication

Requires a Bearer token. See [Authentication](/api-reference/authentication).

## Request Examples

<CodeGroup>
  ```bash curl theme={null}
  curl https://www.hitheo.ai/api/v1/tools \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  const tools = await theo.tools();
  ```
</CodeGroup>

## Response

<ResponseField name="tools" type="object[]">
  Array of tool definition objects. Each includes `name`, `description`, `inputSchema`, `category`, `permissionLevel`, and `requiresApproval`.
</ResponseField>