Re-pin a catalogue Look
Writes the next revision of the look as a draft, from revision with every pin
moved to what is current: a variant entry to the variant’s active revision under
the same application_id, a custom entry to the current profile. diff lists
each entry whose pin moved as {field, from, to}, and is empty when nothing did.
The source revision never changes. A pin with no current equivalent — a slug
the active revision no longer declares, a retired variant — is refused at its
entry and nothing is written. A retired look is 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
API key for one environment of your account. Keep server-side; never expose in browser clients.
Path parameters
Headers
Request
Write a new draft revision from revision with every pin moved to what is
current: each variant entry to its variant’s active revision, keeping its
application_id; each custom entry to the category’s current profile, with
its colour and options re-resolved. The source revision never changes.
Response
One revision of a look. Its pins never change; decision_state moves once,
from draft. The digests read as a variant revision’s.