---
title: "List available tools"
method: GET
path: "/tools"
tags: ["Chats", "dev-api"]
---

# List available tools

`GET /tools`

## Request

- Base URL: `https://gateway.prem.io`
- URL: `https://gateway.prem.io/tools`
- Auth: none declared

Get a list of all available tools that can be used by the AI assistant

## Response `200`

Tools list retrieved successfully

- object
  - `status` 200 | 201 | 202, required: Status code of the response
  - `data` ChatsTool[], nullable, required
    - `name` string, required: Technical name of the tool
    - `normalizedName` string, required: Human-readable display name of the tool
    - `description` string, required: Description of what the tool does
    - `shortName` string, required: Short name of the tool
  - `error` string, nullable: Error message of the response, human readable
  - `message` string, nullable, required: Message of the response, human readable
  - `env` 'development' | 'production', required: API environment
  - `log` union: Useful informaiton, not always present, to debug the response
    - string
    - object
  - `validator` union: Validator response object, each key is the field name and value is the error message
    - object
    - unknown[]
      - unknown
  - `support_id` string, uuid, nullable: Support ID linked to the response, used to identify it when talking with our team.

## Changes

- **2026-10-16** `d5b1beb33be5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/premai-io/apis/prem-studio-api/changes/tools/get.md)

---

[API](https://skmtc.dev/premai-io/apis/prem-studio-api.md) - [All operations](https://skmtc.dev/premai-io/apis/prem-studio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/premai-io/apis/prem-studio-api/revisions/d46bc3931b34?raw)