---
title: "Explicitly link an Interaction revision to one canonical human review Resource."
method: POST
path: "/api/v1/interactions/{interactionId}/review-escalation"
tags: ["Interactions"]
---

# Explicitly link an Interaction revision to one canonical human review Resource.

`POST /api/v1/interactions/{interactionId}/review-escalation`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/interactions/{interactionId}/review-escalation`
- Auth: API key in cookie `commentary_session`

A same-origin authenticated human chooses the review type. Review approval accepts the artifact revision and never represents external execution.

## Path parameters

- `interactionId` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `revisionId` string, required
  - `proposalFingerprint` string, required
  - `reviewType` 'document_review' | 'form_workflow' | 'brain_review' | 'live_preview_review', required
  - `confirmation` object, required
    - `reviewType` 'document_review' | 'form_workflow' | 'brain_review' | 'live_preview_review', required
    - `acknowledgedNoExecution` true, required
  - `target` object, required
    - `mode` 'create' | 'link', required
    - `resourceId` string
    - `revisionId` string, nullable
    - `create` object

## Response `200`

Successful response.

- object

## Other responses

- `201`: Successful response.
- `400`: The request was invalid.
- `401`: Authentication is required.
- `403`: The token or session does not have permission for this resource.
- `404`: The resource was not found.
- `409`: The Interaction changed or already links a different review type.
- `410`: Interaction content was purged.
- `429`: The request was rate limited.

---

[API](https://skmtc.dev/commentary/apis/commentary-public-api.md) · [All operations](https://skmtc.dev/commentary/apis/commentary-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/commentary/apis/commentary-public-api/revisions/7aaafc198c52?raw)