# List

`GET /workspaces/:workspace/artifacts/:artifact_id/versions`

Get artifact versions list

**Required Scopes:** `ARTIFACT_READ`

## URL Parameters

```typescript
interface URLParameters {
  /** The human-readable ID of the workspace */
  workspace: string; // Example: "my-company"
  /** The Artifact ID */
  artifact_id: string; // Example: "x5169jL2"
}
```

## Query Parameters

```typescript
interface QueryParameters {
  /** Page number for pagination */
  page?: number; // Example: 1
  /** Number of items per page */
  per_page?: number; // Example: 20
}
```

## Response Body

```typescript
interface ResponseBody {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** List of artifact versions */
  versions?: ShortArtifactVersionView[];
}
```

## Type Definitions

```typescript
interface ShortArtifactVersionView {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The unique ID of the version (used in API endpoints) */
  id?: number;
  /** The version identifier (e.g., latest, v1.2.0, stable) */
  version?: string;
  /** Size of the version content in bytes */
  size?: number;
  /** Direct URL to access the artifact version content. For CONTAINER artifacts, this is the registry URL (e.g., container.registry.sh/ttests/ubuntu:latest). For FILES artifacts, this is the HTTP server URL where the content is served (e.g., https://latest-my-artifact.bucket-1.registry.sh/) */
  version_url?: string;
  /** Version creation timestamp */
  created_date?: string;
}

```

## Response Example

**Status:** `200 OK`

```json
{
  "url": "https://api.buddy.works/workspaces/ttests/artifacts/x5169jL2/versions",
  "html_url": "https://app.buddy.works/ttests/-/artifacts/x5169jL2/versions",
  "versions": [
    {
      "url": "https://api.buddy.works/workspaces/ttests/artifacts/x5169jL2/versions/0YgEzRGv",
      "html_url": "https://app.buddy.works/ttests/-/artifacts/x5169jL2/versions/0YgEzRGv",
      "version_url": "https://latest-my-artifact.bucket-1.registry.sh/",
      "id": "0YgEzRGv",
      "version": "latest",
      "size": 1048576,
      "created_date": "2024-01-20T10:30:00Z"
    },
    {
      "url": "https://api.buddy.works/workspaces/ttests/artifacts/x5169jL2/versions/WpgpeR2J",
      "html_url": "https://app.buddy.works/ttests/-/artifacts/x5169jL2/versions/WpgpeR2J",
      "version_url": "https://v1-1-0-my-artifact.bucket-1.registry.sh/",
      "id": "WpgpeR2J",
      "version": "v1.1.0",
      "size": 987654,
      "created_date": "2024-01-15T08:20:00Z"
    }
  ]
}
```

---
Original source: https://buddy.works/docs/api/artifacts/versions/list