latestOpenAPI 3.0.02026-08-10221235717.8 KB

e21ad140ec3c

public

ArtefactVersion

List all Artefact Versions of an Artefact.

Returns the Artefact Versions of a specified Artefact registered with your organization. If no elements are found, an empty list is returned.

get/orgs/{orgId}/artefacts/{artefactId}/versions

Path parameters

orgIdstring required

The organization ID.

artefactIdstring required

The Artefact ID.

Query parameters

archivedboolean

(Optional) Filter for non-archived Artefact Versions. If no filter is defined only non-archived Artefact Versions are returned, if the filter is true both archived and non-archived Versions are returned.

referencestring

(Optional) Filter Artefact Versions by by name including a version or digest.

limitinteger

(Optional) Limit the number of versions returned by the endpoint.

Response

Returns all Versions of the specified Artefact.

Example response

[
  {
    "type": "container",
    "artefact_id": "01234567-89ab-cdef-0123-456789abcdef",
    "commit": "060c3d6530a881afb808f105f36af25e1ad1b2f3",
    "created_at": "2020-06-22T09:37:23.523Z",
    "created_by": "01234567-89ab-cdef-0123-456789abcdef",
    "id": "01234567-89ab-cdef-0123-456789abcdef",
    "name": "registry.humanitec.io/my-org/my-service",
    "ref": "refs/heads/main",
    "updated_at": "2020-06-22T09:37:23.523Z",
    "updated_by": "01234567-89ab-cdef-0123-456789abcdef",
    "version": "1.2.7",
    "digest": "sha256:8414aa82208bc4c2761dc149df67e25c6b8a9380e5d8c4e7b5c84ca2d04bb244"
  }
]