Reject a catalogue Variant revision

POST

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

POST

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

curl -X POST https://api.morphiaone.ai/v1/catalogue/variants/variant_id/revisions/revision/reject \
     -H "X-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{}'

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

Rejects a draft revision; a rejected revision is never published. The body is empty or {}. A revision is decided once (409 REVISION_DECIDED). 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

variant_idstringRequired

revisionstringRequired

Request

Reject a draft revision. It takes no digest and is never published.

Response

The revision, rejected

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

409

Conflict Error

503

Service Unavailable Error

Authentication

Path parameters

Headers

Request

Response

Errors