Approve a catalogue Look revision

POST

https://api.morphiaone.ai/v1/catalogue/looks/:look_id/revisions/:revision/approve

POST

/v1/catalogue/looks/:look_id/revisions/:revision/approve

curl -X POST https://api.morphiaone.ai/v1/catalogue/looks/look_id/revisions/revision/approve \
     -H "X-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "approved_snapshot_digest": "string"
}'

{
  "applications": [
    {
      "mode": "variant",
      "application_id": "lips",
      "category": "lipstick",
      "effective_placement": null,
      "revision": 1,
      "variant_id": "var_1kz8m3q5r7t9v1x3z5b7d9f1h3"
    },
    {
      "mode": "custom",
      "category": "blush",
      "color": "#C27461",
      "effective_placement": null,
      "options": {
        "intensity": "medium"
      },
      "profile": {
        "digest": "sha256:57bb4f7dfe1f0e110b226b1ed94f1c568e09590769065e696c7ee4acd1433456",
        "id": "blush.standard",
        "version": 1
      }
    }
  ],
  "approved_snapshot_digest": "sha256:0c1c8e0447a95ea97a882d656f05b10b05754ea0ca77d42180490d597e6d2985",
  "authored_intent_digest": "sha256:0f9a2889a0449e1e56bd00040f6c508002ec72225785913c516c3254fd983ad9",
  "created_at": "2026-10-07T10:02:14.118000Z",
  "decided_at": "2026-10-07T10:31:05.642000Z",
  "decision_state": "approved",
  "digest_version": 1,
  "look_id": "look_1m2n4p6q8r0s2t4v6w8x0y2z4a",
  "revision": 1
}

Approves a draft look revision. The body names the approved_snapshot_digest you reviewed; any other answers 409 REVISION_DIGEST_MISMATCH. A revision is decided once (409 REVISION_DECIDED). Approving does not publish. 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.approve 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

revisionstringRequired

Request

Approve a draft look revision, binding the snapshot digest the reviewer read.

approved_snapshot_digeststringRequired

Response

The revision, approved

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

Authentication

Path parameters

Headers

Request

Response

Errors