Skip to navigation
API referenceCatalogue

Revise a catalogue Look

Writes the next revision of the look as a draft: its whole list of applications, never a patch, compiled like a create. An earlier revision and what it pinned never change. A retired look takes no revision (409 LOOK_RETIRED). Send an Idempotency-Key: a retry with the same key and the same request answers the first response, byte for byte, with Idempotency-Replayed: true, so a response you did not receive is safe to retry. Requires the catalogue.write scope, which your account operator provisions; no other catalogue scope implies it. Served only where the catalogue is enabled for your environment.

Authentication

X-API-Keystring

API key for one environment of your account. Keep server-side; never expose in browser clients.

Path parameters

look_idstringRequired

Headers

Idempotency-Keystring or nullOptional

Request

A new revision of a look: its whole recipe, never a patch. It is written as a draft and changes nothing that renders until it is approved and published. A category and placement appear once per look.

applicationslist of objectsRequired

Response

The new revision, a draft
applicationslist of objects
approved_snapshot_digeststringformat: "^sha256:[0-9a-f]{64}$"
authored_intent_digeststringformat: "^sha256:[0-9a-f]{64}$"
created_atdatetime
decided_atdatetime or null
decision_stateenum
Allowed values:
digest_versioninteger
look_idstring
revisioninteger>=1

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
503
Service Unavailable Error