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

# List Tools

> Retrieve all available AI tools for image, video, audio, and 3D generation.

Retrieve a list of all available AI tools.

### Headers

| Name            | Type   | Required | Description  |
| --------------- | ------ | -------- | ------------ |
| `Authorization` | string | Yes      | Your API key |

### Response Fields

| Field                | Type   | Description                                                    |
| -------------------- | ------ | -------------------------------------------------------------- |
| `data`               | array  | List of tools                                                  |
| `data[].slug`        | string | Tool identifier (use in `/api/run`)                            |
| `data[].name`        | string | Display name                                                   |
| `data[].description` | string | Tool description                                               |
| `data[].type`        | string | Tool category                                                  |
| `data[].outputType`  | string | Output media type: `image`, `video`, `audio`, `text`, `object` |
| `data[].thumbnail`   | string | Tool thumbnail URL                                             |

<RequestExample>
  ```bash bash theme={null}
  curl https://api.artificialstudio.ai/api/tools \
    -H "Authorization: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.artificialstudio.ai/api/tools', {
    headers: { 'Authorization': 'YOUR_API_KEY' }
  });

  const { data } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.artificialstudio.ai/api/tools',
      headers={'Authorization': 'YOUR_API_KEY'}
  )

  tools = response.json()['data']
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "slug": "create-image",
        "name": "Create Image",
        "description": "Generate images from text prompts",
        "type": "image",
        "outputType": "image",
        "thumbnail": "https://..."
      },
      {
        "slug": "create-video",
        "name": "Create Video",
        "description": "Create videos from text or images",
        "type": "video",
        "outputType": "video",
        "thumbnail": "https://..."
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "message": "Invalid or missing API key"
  }
  ```

  ```json 429 theme={null}
  {
    "message": "Too many API requests, please try again later"
  }
  ```
</ResponseExample>