Skip to navigation

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

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

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.

revisionintegerRequired

Response

The new draft revision and the pins it moved
difflist of objects
revisionobject

One revision of a look. Its pins never change; decision_state moves once, from draft. The digests read as a variant revision’s.

Errors

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