Sign in

v4

latestOpenAPI 3.0.1Apache 2.02026-07-312457525.9 MB
Artifact Versions API

Create a new artifact version

post/workspaces/{workspace_domain}/artifacts/{artifactId}/versions

Path parameters

workspace_domainstring required
Example:my-company

The human-readable ID of the workspace

artifactIdstring required
Example:x5169jL2

The Artifact ID

Request body

versionstring required

The version identifier (e.g., latest, v1.2.0, stable)

fromstring

Version to copy content from

Example request

{
  "version": "v1.2.1"
}

Response

urlstring

API endpoint to GET this object

html_urlstring

Web URL to view this object in Buddy.works

idinteger

The unique ID of the version (used in API endpoints)

versionstring

The version identifier (e.g., latest, v1.2.0, stable)

sizeinteger

Size of the version content in bytes

version_urlstring

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_datestring date-time

Version creation timestamp

Example response

{
  "version": "latest",
  "size": 1048576,
  "version_url": "https://latest-my-artifact.bucket-1.registry.sh/",
  "created_date": "2024-01-20T10:30:00Z"
}