Record an operator review disposition for a Worker drift finding.

POST

/api/admin/platform/control-plane/drift-findings/{findingId}/review

Code sample: Shell / cURL

curl --request POST \
  --url https://auth.example.com/api/admin/platform/control-plane/drift-findings/example/review \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "disposition": "reviewed" }'

Marks an active finding as reviewed or dismissed and writes Management and Control audit evidence. The operation does not mutate Cloudflare Worker inventory or desired state.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

findingId

required

string

>= 1 characters <= 512 characters /^drift:[a-zA-Z0-9._:-]+:actual_only:[a-zA-Z0-9._-]+$/

Header Parameters

Idempotency-Key

required

string

>= 1 characters <= 256 characters /^[a-zA-Z0-9][a-zA-Z0-9._:-]*$/

Request Body ^required

Media type application/json

object

disposition

required

string

Allowed values: reviewed dismissed

key

additional properties

Responses

200

Review disposition recorded.

Media type application/json

object

finding

required

object

findingId

required

string

/^drift:[a-zA-Z0-9._:-]+:actual_only:[a-zA-Z0-9._-]+$/

environmentId

required

string

workerScriptName

required

string

findingKind

required

string

Allowed value: actual_only

severity

required

string

Allowed value: warning

reviewState

required

string

Allowed values: unreviewed reviewed dismissed

notificationState

required

string

Allowed values: pending acknowledged

firstObservedAt

required

integer format: int64

lastObservedAt

required

integer format: int64

resolvedAt

required

null

notifiedAt

required

integer | null format: int64

key

additional properties

auditId

required

string

key

additional properties

Example

{
  "finding": {
    "findingKind": "actual_only",
    "severity": "warning",
    "reviewState": "unreviewed",
    "notificationState": "pending"
  }
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

503

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}