Skip to content

Delete a BYO review-agent link (console plane)

DELETE
/v1/admin/orgs/{org_id}/projects/{project_id}/review-links/{rvl_id}

Remove a review link AND sweep every in-flight review currently routed through it back to the HUMAN queue; no orphan deliveries (§9): a review held by the deleted reviewer must not stay assigned to a reviewer that no longer exists. Console-only (Clerk-authed). A foreign id is 404.

org_id
required
string
project_id
required
string
rvl_id
required
string

Ok

The delete outcome plus how many in-flight reviews were swept back to the human queue (no orphan deliveries; §9).

object
deleted
required
boolean
swept
required

In-flight reviews returned to the human queue by the delete.

integer

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Resource not found.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope