Retire a catalogue Look
Retires the look at expected_generation (409 GENERATION_CONFLICT if it moved):
a new try-on naming it is refused and it takes no new revision. Retiring is final
(409 LOOK_RETIRED after). A job already admitted from the look still replays
what it was admitted as.
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.publish 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_id
Headers
Idempotency-Key
Request
Retire the look for good.
expected_generation
Response
The look, retired
active_revision
availability
Allowed values:
created_at
generation
id
latest_revision
updated_at
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
503
Service Unavailable Error