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

# List Tool Versions

> Lists all registered versions of a tool.

## Endpoint

`GET https://gateway.orkeia.ai/tools/{id}/version-control`

**Authentication**\
Requires header `authorization:  <your_token>`.

## Path Parameters

| Name | Type   | Required | Description                    | Example      |
| ---- | ------ | -------- | ------------------------------ | ------------ |
| id   | string | Yes      | Unique identifier of the tool. | TOOL\_123456 |

## Example (cURL)

```bash theme={null}
curl -X GET "https://gateway.orkeia.ai/tools/TOOL_123456/version-control"   -H "authorization:  <your_token>"
```

## Responses

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": [
    { "version": 1, "timestamp": "2024-07-01T12:00:00Z" },
    { "version": 2, "timestamp": "2024-07-10T09:30:00Z" }
  ]
}
```

### 500 — Server Error

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Client Error

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```

## Fields

| Field     | Type   | Description                               |
| --------- | ------ | ----------------------------------------- |
| version   | number | Version number of the tool.               |
| timestamp | string | Date/time of version creation (ISO 8601). |