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. Revocations this host holds for the target catalog address carry into it and 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
assign_trust_revisionAssign Trust Revision (boolean)

Have the host give trust the next revision of the target address's own trust history, in place of the revision supplied. The dashboard sets this, so re-adding a catalog is never refused as a rollback whatever revision it last held; requires trust.

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,
  "assign_trust_revision": false
}