Read a catalogue Look revision

GET

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

GET

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

curl https://api.morphiaone.ai/v1/catalogue/looks/look_id/revisions/revision \
     -H "X-API-Key: <apiKey>"

{
  "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
}

One immutable look revision: each entry as compiled, with the variant revision or profile it pinned, its decision_state, and two content digests (digest_version 1). approved_snapshot_digest identifies what renders and is the value an approval names. A revision the look does not have answers 404 LOOK_NOT_FOUND. Requires the catalogue.read 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

Response

The revision

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

503

Service Unavailable Error