Reject a colour Candidate | MorphiaOne Docs

curl -X POST https://api.morphiaone.ai/v1/digitisation/candidates/candidate_id/reject \
     -H "X-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "candidate_sha256": "string"
}'

{
  "assessment_id": "assessment_3t38gf4mbt0y96z8pzmp4w5mpq",
  "candidate": {
    "assessment_id": "assessment_3t38gf4mbt0y96z8pzmp4w5mpq",
    "assessment_output_sha256": "67b810e77d19f628534a2128d402605b8cc81aa1d43828793f2701f19ce8b97a",
    "colour_contract_version": 1,
    "kind": "digitisation.candidate",
    "report": {
      "analyzed_bytes_sha256": "9229dacfcfb7a93b54efccf2119c2e417546d10ed3fce2a18a067294b646c5a2",
      "clipped_fraction": 0,
      "colour_contract_version": 1,
      "icc_profile_sha256": null,
      "image": {
        "height": 64,
        "width": 64
      },
      "kind": "digitisation.colour_report",
      "lab_d65": [
        33.3028,
        42.2729,
        -74.7134
      ],
      "mean_linear_rgb": [
        0.012983,
        0.045186,
        0.57758
      ],
      "region": [
        0,
        0,
        32,
        32
      ],
      "source_colour": "untagged",
      "srgb_hex": "#1E3CC8"
    },
    "report_sha256": "13b9231215003368dc58598699f5aaf93c8b49b13561c1667aebbb065681110f",
    "source": {
      "analyzed_bytes_sha256": "9229dacfcfb7a93b54efccf2119c2e417546d10ed3fce2a18a067294b646c5a2",
      "evidence_id": "evidence_6952rp5rnjq4bpn9sk93vbq6pv",
      "region": [
        0,
        0,
        32,
        32
      ]
    }
  },
  "candidate_sha256": "e1e9fdf2e1a9fe90712dad6a3247af7c4b6b6144d770a9070983f1d665fe71bb",
  "colour_contract_version": 1,
  "created_at": "2026-10-22T03:21:05.118204Z",
  "derived_from_candidate_id": null,
  "fields": {
    "display_color": {
      "status": "measured",
      "value": "#1E3CC8"
    },
    "material.finish": {
      "status": "abstained",
      "value": null
    }
  },
  "id": "candidate_5w2kq8n4fz7yr3tm6vx9bhcj1d",
  "review_status": "rejected",
  "reviewed_at": "2026-10-22T03:25:12.640187Z"
}

Rejects a pending candidate. Send the candidate_sha256 you reviewed: a candidate already decided answers 409 CANDIDATE_DECIDED, and another digest 409 CANDIDATE_DIGEST_MISMATCH. Rejection needs no evidence, so it holds once the evidence is erased. Making the same candidate again answers this rejected one; the review is not reopened. Send an Idempotency-Key: it is required, and a retry with the same key and the same request answers the first response, byte for byte, with Idempotency-Replayed: true. Requires the digitisation.review scope, which your account operator provisions; served only where digitisation 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

candidate_idstringRequired

Request

Accept or reject a candidate: the digest of the candidate the reviewer saw.

candidate_sha256stringRequired

Response

The candidate, rejected; a replay under the same Idempotency-Key answers with Idempotency-Replayed: true

assessment_idstring

candidatemap from strings to any

candidate_sha256stringformat: "^[0-9a-f]{64}$"

colour_contract_versioninteger

created_atdatetime

derived_from_candidate_idstring or null

fieldsmap from strings to objects

idstring

review_statusenum

Allowed values:

reviewed_atdatetime or null

review_urlstring or nullOptional

reviewed_byobject or nullOptional

Who made a decision: user, a person in the Platform, or api_key. It names no person; the Platform shows who.

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