Sign in

v51

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-01131107332.8 KB
Metadata

Get artifact version metadata

Retrieves the metadata for a single version of the artifact. The version metadata is a subset of the artifact metadata and only includes the metadata that is specific to the version (for example, this doesn't include modifiedOn).

This operation can fail for the following reasons:

  • No artifact with this artifactId exists (HTTP error 404)
  • No version with this version exists (HTTP error 404)
  • A server error occurred (HTTP error 500)
get/groups/{groupId}/artifacts/{artifactId}/versions/{versionExpression}

Response

The artifact version's metadata.

versionstring required

A single version of an artifact. Can be provided by the client when creating a new version, or it can be server-generated. The value can be any string unique to the artifact, but it is recommended to use a simple integer or a semver value.

namestring
descriptionstring
ownerstring required
createdOnstring date-time required
artifactTypestring required
globalIdinteger required
state'ENABLED' | 'DISABLED' | 'DEPRECATED' | 'DRAFT' | 'SUNSET'

Describes the state of an artifact or artifact version.

  • ENABLED
  • DISABLED
  • DEPRECATED
  • DRAFT
  • SUNSET — Signals that a migration deadline has passed and the version will be removed. Requires transitioning through DEPRECATED first. Added in 3.3.0.
labelsLabels

User-defined name-value pairs. Name and value must be strings.

groupIdstring

An ID of a single artifact group.

contentIdinteger required
artifactIdstring required

The ID of a single artifact.

modifiedBystring
modifiedOnstring date-time

Example response

{
  "groupId": "My-Group",
  "artifactId": "my-artifact-id",
  "version": 1221432,
  "artifactType": "PROTOBUF",
  "name": "Artifact Name",
  "description": "The description of the artifact",
  "owner": "user1",
  "createdOn": "2019-05-17T12:00:00Z",
  "globalId": 183282932983,
  "contentId": 12347,
  "labels": {
    "custom-1": "foo",
    "custom-2": "bar"
  }
}