Set the account-default review policy (console plane, human authority)

PATCH

/v1/admin/orgs/{org_id}/projects/{project_id}/review-policy

• Production
• Local

Set the account-default review policy (D6). An invalid policy value is 400. Console-only (never an MCP tool, D17).

Authorizations

• ClerkSession

Parameters

Path Parameters

org_id

required

string

project_id

required

string

Request Body ^required

Set the account-default review policy (D6). An invalid value is 400.

object

policy

required

string

Allowed values: require_review allow_direct auto_send_graduated

Responses

200

Ok

The account-default review policy (D6) plus the effective floor an inbox with no override resolves to (require_review is the safe floor).

object

policy

required

string

Allowed values: require_review allow_direct auto_send_graduated

effective

required

string

Allowed values: require_review allow_direct auto_send_graduated

400

Invalid request.

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

401

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

403

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