---
title: "Create version and and upload content"
method: POST
path: "/workspaces/{workspace_domain}/artifacts/{artifactId}/versions/upload"
tags: ["Artifact Versions API"]
---

# Create version and and upload content

`POST /workspaces/{workspace_domain}/artifacts/{artifactId}/versions/upload`

## Path parameters

- `workspace_domain` string, required
- `artifactId` string, required

## Response `201`

- ArtifactVersionView — Full representation of a artifact version
  - `url` string — API endpoint to GET this object
  - `html_url` string — Web URL to view this object in Buddy.works
  - `id` integer — The unique ID of the version (used in API endpoints)
  - `version` string — The version identifier (e.g., latest, v1.2.0, stable)
  - `size` integer — Size of the version content in bytes
  - `note` string — Note for this resource
  - `agent_note` string — YAML note for AI agents operating on this resource
  - `version_url` string — 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/)
  - `created_date` string, date-time — Version creation timestamp

## Changes

- **2026-08-04** `2426d67c249a` — 2 info
  - added the optional property `agent_note` to the response with the `201` status
  - added the optional property `note` to the response with the `201` status
- **2026-07-31** `bf56ba86dd4d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/buddy/apis/buddy-api/changes/workspaces/:workspace_domain/artifacts/:artifactId/versions/upload/post.md)

---

[API](https://skmtc.dev/buddy/apis/buddy-api.md) · [All operations](https://skmtc.dev/buddy/apis/buddy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/buddy/buddy-api/revisions/fa785a68f09d/schema)