NUnullplatform
Artifact

List platform artifacts

Changed on

List artifacts.

Prefer the visible_to filter for consumption. It matches artifacts owned at the NRN, shared by ancestors or trailing-wildcard scopes, and global artifacts published with organization=*, which an owner nrn filter never returns.

id accepts up to 200 comma-separated ids as a batched read. Every requested artifact must be readable by the caller.

get/artifacts

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/artifacts
  • Auth
    HTTP bearer

Query parameters

nrnstring

Filter by exact owner NRN.

visible_tostring

Return artifacts visible at this NRN: ancestors, trailing-wildcard scopes and the global wildcard all match. A trailing-wildcard value (for example, "organization=1:account=*") also matches artifacts visible to any of its descendants.

type'oci_image' | 'oras_artifact' | 'git_repository' | 'blob'

Filter by artifact type.

idstring

Comma-separated artifact ids (up to 200): a batched read, authorized per artifact like reading each one.

sortstring

Sort as field:direction, where field is created_at or updated_at.

offsetinteger

The starting point for pagination.

limitinteger

The maximum number of results to return per page.

Response

The artifacts matching the query.

Example response

{
  "paging": {
    "limit": 20
  },
  "results": [
    {
      "resource_id": "5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f",
      "type": "oci_image",
      "nrn": "organization=1:account=2",
      "identity_meta": {
        "registry": "123456789012.dkr.ecr.us-east-1.amazonaws.com",
        "repository": "my-org/my-scope"
      },
      "revision_count": 3,
      "latest_revision_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
      "created_at": "2026-09-14T12:00:00.000Z"
    }
  ]
}

Changes