---
title: "Read monitoring service assurance"
method: POST
path: "/v1/commands/get_monitoring_service_assurance"
tags: ["Link monitoring and evidence"]
---

# Read monitoring service assurance

`POST /v1/commands/get_monitoring_service_assurance`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/get_monitoring_service_assurance`
- 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

- GetMonitoringServiceAssuranceInput
  - `projectId` string, required: project ID from create/list.

## Response `200`

Command result, including queued admission.

- GetMonitoringServiceAssuranceOutput
  - `schemaVersion` 1, required
  - `workspaceId` string, required
  - `projectId` string, required
  - `asOf` string, date-time, required
  - `source` object, required
    - `supplied` integer, required
    - `active` integer, required
    - `paused` integer, required
    - `neverAttempted` integer, required
    - `neverConclusive` integer, required
    - `due` integer, required
    - `overdue` integer, required
    - `currentUnknown` integer, required
    - `latestAttemptAt` string, date-time, nullable, required
    - `oldestAttemptAt` string, date-time, nullable, required
    - `oldestAttemptAgeSeconds` number, nullable, required
    - `latestConclusiveAt` string, date-time, nullable, required
    - `oldestConclusiveAt` string, date-time, nullable, required
    - `oldestConclusiveAgeSeconds` number, nullable, required
  - `target` object, required
    - `supplied` integer, required
    - `active` integer, required
    - `paused` integer, required
    - `neverAttempted` integer, required
    - `neverConclusive` integer, required
    - `due` integer, required
    - `overdue` integer, required
    - `currentUnknown` integer, required
    - `latestAttemptAt` string, date-time, nullable, required
    - `oldestAttemptAt` string, date-time, nullable, required
    - `oldestAttemptAgeSeconds` number, nullable, required
    - `latestConclusiveAt` string, date-time, nullable, required
    - `oldestConclusiveAt` string, date-time, nullable, required
    - `oldestConclusiveAgeSeconds` number, nullable, required
  - `monitoringProjection` object
    - `schemaVersion` 1, required
    - `source` object, required
      - `coverage` object, required: Dataset scope and completeness, including limits on what these results establish.
        - `supplied` integer, required
        - `active` integer, required
        - `paused` integer, required
        - `recordedHeld` integer, required
        - `schedulingCandidates` integer, required
        - `busy` integer, required
        - `dueCandidates` integer, required
        - `eligibility` object, required
          - `status` 'unavailable', required: Resource lifecycle status.
          - `eligible` unknown, required
          - `reason` 'admission_not_rechecked', required: Recorded explanation.
        - `denominatorMeaning` string, required
        - `freshnessWindow` string, required
        - `cadenceSeconds` object, required
          - `minimum` integer, nullable, required
          - `maximum` integer, nullable, required
        - `oldestOverdueAt` string, date-time, nullable, required
        - `oldestOverdueAgeSeconds` number, nullable, required
        - `nextScheduledAt` string, date-time, nullable, required
        - `nextEligibleAt` unknown, required
        - `nextEligibleReason` 'admission_not_rechecked', required
        - `neverAttempted` integer, required
        - `neverConclusive` integer, required
        - `currentUnknown` integer, required
        - `unknownReasons` object, required
        - `freshConclusive` integer, required
        - `staleConclusive` integer, required
        - `shares` object, required
          - `currentUnknown` number, nullable, required
          - `neverAttempted` number, nullable, required
          - `freshConclusive` number, nullable, required
        - `shareMeaning` string, required
        - `freshRetainedLinkVerification` integer
        - `linkVerificationMeaning` string
        - `reasonCounts` object, required
          - `due` object, required
          - `deferred` object, required
          - `unavailable` object
      - `jobs` object, required
        - `retained` integer, required
        - `queued` integer, required
        - `running` integer, required
        - `succeeded` integer, required
        - `failed` integer, required
        - `cancelled` integer, required
        - `everClaimed` integer, required
        - `claimAttempts` integer, required
        - `retryClaims` integer, required
        - `retryExhausted` integer, required
        - `expiredRunningLeases` integer, required
        - `oldestQueuedAt` string, date-time, nullable, required
        - `oldestQueuedAgeSeconds` number, nullable, required
        - `oldestRunningAdmissionAt` string, date-time, nullable, required
        - `oldestRunningAdmissionAgeSeconds` number, nullable, required
        - `latestAdmissionAt` string, date-time, nullable, required
        - `latestCompletionAt` string, date-time, nullable, required
        - `scopedRetainedDeadLetters` integer, required
        - `deadLetterMeaning` string, required
        - `admissionToTerminal` object, required
          - `samples` integer, required
          - `minimumSeconds` number, nullable, required
          - `maximumSeconds` number, nullable, required
          - `meaning` string, required
        - `startedAt` unknown, required
        - `queueWaitSeconds` unknown, required
        - `providerLatencySeconds` unknown, required
        - `timingReason` 'first_start_and_provider_timing_not_retained', required
        - `dispatch` object, required
          - `outstanding` integer, required
          - `deferred` integer, required
          - `expiredSendingLeases` integer, required
          - `nextDispatchAt` string, date-time, nullable, required
          - `meaning` string, required
        - `historyMeaning` string, required
    - `target` object, required
      - `coverage` object, required: Dataset scope and completeness, including limits on what these results establish.
        - `supplied` integer, required
        - `active` integer, required
        - `paused` integer, required
        - `recordedHeld` integer, required
        - `schedulingCandidates` integer, required
        - `busy` integer, required
        - `dueCandidates` integer, required
        - `eligibility` object, required
          - `status` 'unavailable', required: Resource lifecycle status.
          - `eligible` unknown, required
          - `reason` 'admission_not_rechecked', required: Recorded explanation.
        - `denominatorMeaning` string, required
        - `freshnessWindow` string, required
        - `cadenceSeconds` object, required
          - `minimum` integer, nullable, required
          - `maximum` integer, nullable, required
        - `oldestOverdueAt` string, date-time, nullable, required
        - `oldestOverdueAgeSeconds` number, nullable, required
        - `nextScheduledAt` string, date-time, nullable, required
        - `nextEligibleAt` unknown, required
        - `nextEligibleReason` 'admission_not_rechecked', required
        - `neverAttempted` integer, required
        - `neverConclusive` integer, required
        - `currentUnknown` integer, required
        - `unknownReasons` object, required
        - `freshConclusive` integer, required
        - `staleConclusive` integer, required
        - `shares` object, required
          - `currentUnknown` number, nullable, required
          - `neverAttempted` number, nullable, required
          - `freshConclusive` number, nullable, required
        - `shareMeaning` string, required
        - `freshRetainedLinkVerification` integer
        - `linkVerificationMeaning` string
        - `reasonCounts` object, required
          - `due` object, required
          - `deferred` object, required
          - `unavailable` object
      - `jobs` object, required
        - `retained` integer, required
        - `queued` integer, required
        - `running` integer, required
        - `succeeded` integer, required
        - `failed` integer, required
        - `cancelled` integer, required
        - `everClaimed` integer, required
        - `claimAttempts` integer, required
        - `retryClaims` integer, required
        - `retryExhausted` integer, required
        - `expiredRunningLeases` integer, required
        - `oldestQueuedAt` string, date-time, nullable, required
        - `oldestQueuedAgeSeconds` number, nullable, required
        - `oldestRunningAdmissionAt` string, date-time, nullable, required
        - `oldestRunningAdmissionAgeSeconds` number, nullable, required
        - `latestAdmissionAt` string, date-time, nullable, required
        - `latestCompletionAt` string, date-time, nullable, required
        - `scopedRetainedDeadLetters` integer, required
        - `deadLetterMeaning` string, required
        - `admissionToTerminal` object, required
          - `samples` integer, required
          - `minimumSeconds` number, nullable, required
          - `maximumSeconds` number, nullable, required
          - `meaning` string, required
        - `startedAt` unknown, required
        - `queueWaitSeconds` unknown, required
        - `providerLatencySeconds` unknown, required
        - `timingReason` 'first_start_and_provider_timing_not_retained', required
        - `dispatch` object, required
          - `outstanding` integer, required
          - `deferred` integer, required
          - `expiredSendingLeases` integer, required
          - `nextDispatchAt` string, date-time, nullable, required
          - `meaning` string, required
        - `historyMeaning` string, required
    - `index` union, required
      - object
        - `status` 'denied', required: Resource lifecycle status.
        - `reason` string, required: Recorded explanation.
      - object
        - `status` 'unavailable', required: Resource lifecycle status.
        - `reason` string, required: Recorded explanation.
      - object
        - `status` 'available', required: Resource lifecycle status.
        - `reason` string, required: Recorded explanation.
        - `suppliedSourceWatches` integer, required
        - `activeSourceWatches` integer, required
        - `lanes` object[], required
          - `lane` 'gsc' | 'licensed_site', required
          - `retainedStates` integer, required
          - `observedActiveWatches` integer, required
          - `neverObservedActiveWatches` integer, required
          - `currentUnknownStates` integer, required
          - `latestObservationAt` string, date-time, nullable, required
          - `oldestObservationAt` string, date-time, nullable, required
          - `oldestObservationAgeSeconds` number, nullable, required
        - `schedule` union, required
          - object
            - `status` 'unavailable', required: Resource lifecycle status.
            - `reason` 'schema_unavailable', required: Recorded explanation.
          - object
            - `status` 'available', required: Resource lifecycle status.
            - `projectOptedIn` boolean, required
            - `inspectionEnabled` boolean, required
            - `schedulerEnabled` boolean, required
            - `cadenceSeconds` integer, nullable, required
            - `dailyLimit` integer, nullable, required
            - `nextProjectScanAt` string, date-time, nullable, required
            - `propertyEligibleWatches` unknown, required
            - `propertyEligibilityReason` 'current_source_property_grant_not_assessed', required
            - `eligibleWatches` unknown, required
            - `eligibilityReason` 'admission_not_rechecked', required
        - `meaning` string, required
    - `serviceTickWindow` object, required
      - `expectedTicks` unknown, required
      - `completedTicks` unknown, required
      - `availabilityShare` unknown, required
      - `reason` 'tick_history_not_retained', required: Recorded explanation.
    - `capacity` object, required
      - `dueOpportunities` unknown, required
      - `missedOpportunities` unknown, required
      - `checksPerEligibleWatch` unknown, required
      - `reason` 'bounded_roster_opportunity_history_not_retained', required: Recorded explanation.
    - `meaning` string, required
  - `sourceLinkVerification` object, required
    - `latestRetainedAt` string, date-time, nullable, required
    - `oldestRetainedAt` string, date-time, nullable, required
    - `observedWatches` integer, required
    - `meaning` string, required
  - `sourceJobs` object, required
    - `queued` integer, required
    - `running` integer, required
  - `overdueReasons` object, required
  - `index` union, required
    - object
      - `status` 'available', required: Resource lifecycle status.
      - `reason` string, required: Recorded explanation.
      - `observedWatches` integer, required
      - `latestObservationAt` string, date-time, nullable, required
      - `oldestObservationAt` string, date-time, nullable, required
      - `oldestObservationAgeSeconds` number, nullable, required
      - `denominator` string, required
    - object
      - `status` 'denied', required: Resource lifecycle status.
      - `reason` string, required: Recorded explanation.
    - object
      - `status` 'unavailable', required: Resource lifecycle status.
      - `reason` string, required: Recorded explanation.
  - `serviceTicks` object, required
    - `status` 'available' | 'unavailable', required: Resource lifecycle status.
    - `meaning` string, required
    - `items` object[], required: Records in this bounded page.
      - `plan` string, required
      - `latestAttemptAt` string, date-time, required
      - `latestCompletionAt` string, date-time, nullable, required
      - `latestSuccessAt` string, date-time, nullable, required
      - `latestOutcome` 'running' | 'succeeded' | 'failed', required
      - `ageSeconds` number, required
  - `assurance` object, required
    - `elapsedSoak` 'not_established', required
    - `backupRestore` 'not_established', required
    - `externalDelivery` 'not_established', required
  - `denominator` string, required

## 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/2a712a1dcfa7?raw)