Link monitoring and evidence

Request a check

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

post/v1/commands/request_check

Request

X-Workspace-IDstring

Required when using a Clerk human session. With an API key, omit this header or supply its bound workspace.

subject'link' | 'target' required

link for a monitored placement (source page → destination), target for a monitored destination URL.

subjectIdstring required

The watch id when subject is link, the target id when subject is target.

idempotencyKeystring required

Caller-generated key reused only for retries of the same operation and arguments in this workspace.

Command result, including queued admission.

idstring required

Resource identifier returned by the operation.

state'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required

Saved lifecycle or evidence state, as enumerated for this record.

workspace_idstring required

Workspace that owns this record.

project_idstring required

Project that owns this record.

watch_idstring

target_idstring

typestring

execution_modestring

idempotency_keystring required

Caller retry identifier, bound to the original request arguments.

payload_hashstring required

attempt_countnumber required

max_attemptsnumber required

lease_tokenstring nullable required

lease_expires_atstring nullable required

error_codestring nullable required

Latest delivery detail code; null when no failure or retry has been recorded.

error_messagestring nullable

created_atstring required

UTC timestamp when the record was created.

updated_atstring required

UTC timestamp of the last record update.

completed_atstring nullable required

replayedboolean

True when the response reuses an earlier request with the same idempotency value.

No recorded changes to this operation across all 2 revisions of this API.