Skip to main content

CatalogSourceUpdate

Explicit owner catalog address and discovery trust; the credential is write-only.

expected_revisionExpected Revision (integer)required

Current catalog source revision, zero before setup.

Possible values: >= 0

base_url object

HTTPS catalog directory; omission retains the configured one.

anyOf
string

Possible values: <= 2048 characters

document_filename object

Signed catalog basename; omission retains the configured name.

anyOf
string

Possible values: <= 206 characters

trust object

Publishers trusted for discovery; omission retains trust. Existing revocations cannot be removed here.

anyOf
revisionRevision (integer)required

Monotonic owner trust revision.

Possible values: >= 1

expires_atExpires At (integer)required

UTC Unix expiry of this trust view.

Possible values: > 0

publishersobjectrequired

Publisher IDs mapped to Ed25519 public keys.

revoked_publishersstring[]

Publishers no longer authorized.

Possible values: <= 16

Default value: []
revoked_artifactsstring[]

Revoked bundle, wheel or runtime digests.

Possible values: <= 128

Default value: []
token object

Write-only catalog bearer; omission retains it.

anyOf
string<password>
clear_tokenClear Token (boolean)

Explicitly read the catalog anonymously.

Default value: false
CatalogSourceUpdate
{
  "expected_revision": 0,
  "base_url": "string",
  "document_filename": "string",
  "trust": {
    "revision": 0,
    "expires_at": 0,
    "publishers": {},
    "revoked_publishers": [
      "string"
    ],
    "revoked_artifacts": [
      "string"
    ]
  },
  "clear_token": false
}