Sign in

v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
orgs

Create artifact metadata storage record

Create metadata storage records for artifacts associated with an organization. This endpoint will create a new artifact storage record on behalf of any artifact matching the provided digest and associated with a repository owned by the organization.

post/orgs/{org}/artifacts/metadata/storage-record

Path parameters

orgstring required

The organization name. The name is not case sensitive.

Request body

namestring required

The name of the artifact.

digeststring required

The digest of the artifact (algorithm:hex-encoded-digest).

versionstring

The artifact version.

artifact_urlstring uri

The URL where the artifact is stored.

pathstring uri

The path of the artifact.

registry_urlstring uri required

The base URL of the artifact registry.

repositorystring

The repository name within the registry.

status'active' | 'eol' | 'deleted'

The status of the artifact (e.g., active, inactive).

github_repositorystring

The name of the GitHub repository associated with the artifact. This should be used when there are no provenance attestations available for the artifact. The repository must belong to the organization specified in the path parameter.

If a provenance attestation is available for the artifact, the API will use the repository information from the attestation instead of this parameter.

return_recordsboolean

If true, the endpoint will return the created record in the response body.

Example request

{
  "name": "libfoo",
  "digest": "sha256:0ecbaa601dba202129058746c7d8e3f282d0efb5fff0...",
  "version": "1.2.3",
  "artifact_url": "https://reg.example.com/artifactory/bar/libfoo-1.2.3",
  "path": "com/github/bar/libfoo-1.2.3",
  "registry_url": "https://reg.example.com/artifactory/",
  "repository": "bar",
  "status": "active",
  "github_repository": "my-github-repo"
}

Response

Artifact metadata storage record stored successfully.

total_countinteger required

Example response

{
  "total_count": 1
}