# Upload

`POST /workspaces/:workspace/artifacts/:artifact_id/versions/:version_id/upload`

Upload artifact version from ZIP archive

**Required Scopes:** `ARTIFACT_WRITE`

## 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"
  /** The Version ID */
  version_id: string; // Example: "a9f84k2L"
}
```

## 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;
  /** 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:** `201 Created`

```json
{
  "url": "https://api.buddy.works/workspaces/ttests/artifacts/x5169jL2/versions/a9f84k2L",
  "html_url": "https://app.buddy.works/ttests/-/artifacts/x5169jL2/versions/a9f84k2L",
  "extracted_files": 25,
  "total_size": 10485760
}
```

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