Read a catalogue Variant revision

GET

https://api.morphiaone.ai/v1/catalogue/variants/:variant_id/revisions/:revision

GET

/v1/catalogue/variants/:variant_id/revisions/:revision

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

{
  "appearance": {
    "display_color": "#C27461"
  },
  "applications": [
    {
      "application_id": "cheeks",
      "category": "blush",
      "effective_placement": null,
      "options": {
        "intensity": "medium"
      },
      "profile": {
        "digest": "sha256:57bb4f7dfe1f0e110b226b1ed94f1c568e09590769065e696c7ee4acd1433456",
        "id": "blush.standard",
        "version": 1
      },
      "render_color": "#C27461"
    },
    {
      "application_id": "lips",
      "category": "lipstick",
      "effective_placement": null,
      "options": {
        "finish": "matte"
      },
      "profile": {
        "digest": "sha256:7c7a98bd64097b6b595d61d4f713da3c6aad2c9a3f267f3e54d1cb5746276b6b",
        "id": "lipstick.standard",
        "version": 1
      },
      "render_color": "#C27461"
    }
  ],
  "approved_snapshot_digest": "sha256:e6890e22e6f60b89f087023d2af43365c845153d6fab0e4c21829073bc87c462",
  "authored_intent_digest": "sha256:2ae83bfee37d936951fe9cd5dcd83ecd55b05d8b5b3f0b2ff742b74239a7c8f1",
  "created_at": "2026-10-06T13:40:02.271000Z",
  "decided_at": "2026-10-06T13:58:47.090000Z",
  "decision_state": "approved",
  "default_application_id": "cheeks",
  "digest_version": 1,
  "display_color": "#C27461",
  "revision": 2,
  "variant_id": "var_1kz8m3q5r7t9v1x3z5b7d9f1h3"
}

One immutable revision: its application definitions as compiled, its decision_state, and two content digests (digest_version 1). authored_intent_digest identifies what was sent; approved_snapshot_digest identifies what renders, and is the value an approval names. A revision the variant does not have answers 404 VARIANT_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

variant_idstringRequired

revisionstringRequired

Response

The revision

appearancemap from strings to any

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:

default_application_idstring

digest_versionenum

Allowed values:

display_colorstringformat: "^#[0-9A-F]{6}$"

revisioninteger>=1

variant_idstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error