---
title: "Monitor selected baseline candidates"
method: POST
path: "/v1/commands/monitor_domain_baseline_candidates"
tags: ["Link monitoring and evidence"]
---

# Monitor selected baseline candidates

`POST /v1/commands/monitor_domain_baseline_candidates`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/monitor_domain_baseline_candidates`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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

## Headers

- `X-Workspace-ID` string

## Request body

- MonitorDomainBaselineCandidatesInput
  - `runId` string, required: run ID from create/list.
  - `idempotencyKey` string, required: Caller-generated key reused only for retries of the same operation and arguments in this workspace.
  - `items` object[], required: Selected stored candidates to check, each by candidateId with an optional localReference for the caller's own record.
    - `candidateId` string, required
    - `verificationJobId` string, required
  - `cadenceSeconds` integer: Check interval in seconds; see bounds.

## Response `200`

Command result, including queued admission.

- MonitorDomainBaselineCandidatesOutput
  - `schema_version` 1, required
  - `id` string, required: Resource identifier returned by the operation.
  - `baseline_run_id` string, required
  - `workspace_id` string, required: Workspace that owns this record.
  - `project_id` string, required: Project that owns this record.
  - `manifest_hash` string, required
  - `cadence_seconds` integer, required
  - `state` 'pending' | 'partial' | 'completed', required: Saved lifecycle or evidence state, as enumerated for this record.
  - `counts` object, required
    - `pending` integer, required
    - `created` integer, required: True when this request created the record; false when an existing record was reused.
    - `already_monitored` integer, required
    - `ineligible` integer, required
    - `failed` integer, required
  - `items` object[], required: Records in this bounded page.
    - `ordinal` integer, required
    - `candidate_id` string, required
    - `verification_job_id` string, required
    - `state` 'pending' | 'created' | 'already_monitored' | 'ineligible' | 'failed', required: Saved lifecycle or evidence state, as enumerated for this record.
    - `error_code` string, nullable, required: Latest delivery detail code; null when no failure or retry has been recorded.
    - `watch_id` string, nullable, required
    - `observation_id` string, nullable, required
    - `local_reference` string, nullable, required: Customer reference for joining this record to a local ledger entry.
    - `attempt_count` integer, required
  - `replayed` boolean, required: True when the response reuses an earlier request with the same idempotency value.

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/1bf30c2912b2?raw)