Skip to main content

Register a platform artifact

POST 
/artifacts

Idempotent upsert. The owner nrn, the type and the identity subset of meta identify the artifact; each unique full meta blob mints (or reuses) one revision. The response carries the artifact and revision ids that package components pin.

Returns 201 when the call created the artifact or a new revision, and 200 when both already existed.

On an artifact that already exists:

  • A visible_to in the body replaces the artifact's visibility.
  • annotations aren't part of the revision identity. When the body carries annotations, they replace the stored set as a whole (last write wins), so always send the complete set. Omitting them keeps the stored set.

ℹ️ Note: For oci_image, tag is part of the revision meta: registering an existing digest under a new tag mints a new revision.

Request​

Responses​

The artifact and revision already existed.