> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Destination Health tools

> Inputs, access and errors for 9 registered destination health tools.

Generated 2026-09-13T03:11:22.248Z from `src/tool-registry.js` by `scripts/export-mint-tool-docs.mjs`. 9 of 62 registered tools. Authenticated cloud tools have REST endpoints under `/v1/`. The anonymous `verify_link_free` tool uses `POST /free/check` and `/free/mcp`.

## list\_targets

List explicitly monitored destination URLs. Checks are independent of source-link presence.

* **State**: Registered and locally tested.
* **Access**: read · scope: `watches:read` · defined at `src/tool-registry.js:92`

| Input       | Type    | Required | Notes                                                                                                         |
| ----------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------- |
| `cursor`    | string  | no       | Opaque continuation returned by this same listing; omit for the first page.                                   |
| `limit`     | integer | no       | Maximum rows in this page or bounded report; subject to the schema maximum.                                   |
| `projectId` | string  | no       | Identifier of the project returned by its create or list operation.                                           |
| `q`         | string  | no       | Text filter applied to saved records; does not start discovery.                                               |
| `state`     | string  | no       | Requested resource state or saved-observation filter, as enumerated here.                                     |
| `status`    | string  | no       | Lifecycle status filter or requested status; this is separate from observation state.; one of: active, paused |

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## get\_target

Read a destination health watch and its current evidence state.

* **State**: Registered and locally tested.
* **Access**: read · scope: `watches:read` · defined at `src/tool-registry.js:93`

| Input      | Type   | Required | Notes                                                              |
| ---------- | ------ | -------- | ------------------------------------------------------------------ |
| `targetId` | string | yes      | Identifier of the target returned by its create or list operation. |

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## monitor\_target

Register an exact public destination URL for recurring health checks. Duplicates within a project are reused. Each completed check uses one unit of the shared monthly check allowance.

* **State**: Registered and locally tested.
* **Access**: write · scope: `watches:write` · defined at `src/tool-registry.js:94`

| Input            | Type       | Required | Notes                                                                |
| ---------------- | ---------- | -------- | -------------------------------------------------------------------- |
| `projectId`      | string     | yes      | Identifier of the project returned by its create or list operation.  |
| `url`            | string/uri | yes      | Public HTTPS endpoint or destination URL required by this operation. |
| `cadenceSeconds` | integer    | no       | Scheduled check interval in seconds, from 3600 to 2592000.           |

**Side effects**: write

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## update\_target

Pause/resume a destination check or change its cadence.

* **State**: Registered and locally tested.
* **Access**: write · scope: `watches:write` · defined at `src/tool-registry.js:95`

| Input            | Type    | Required | Notes                                                                                                         |
| ---------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------- |
| `targetId`       | string  | yes      | Identifier of the target returned by its create or list operation.                                            |
| `status`         | string  | no       | Lifecycle status filter or requested status; this is separate from observation state.; one of: active, paused |
| `cadenceSeconds` | integer | no       | Scheduled check interval in seconds, from 3600 to 2592000.                                                    |

**Side effects**: write

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## request\_target\_check

Queue a metered destination health check. Reuse the idempotency key for a retry; blocked results remain unknown.

* **State**: Registered and locally tested.
* **Access**: write · scope: `watches:write` · defined at `src/tool-registry.js:96`

| Input            | Type   | Required | Notes                                                                                               |
| ---------------- | ------ | -------- | --------------------------------------------------------------------------------------------------- |
| `targetId`       | string | yes      | Identifier of the target returned by its create or list operation.                                  |
| `idempotencyKey` | string | yes      | Caller-generated key reused only for retries of the same operation and arguments in this workspace. |

**Side effects**: write; dispatchJobs(jobId)

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## get\_target\_job

Read progress and usage reservation for an asynchronous destination-health check job.

* **State**: Registered and locally tested.
* **Access**: read · scope: `watches:read` · defined at `src/tool-registry.js:97`

| Input   | Type   | Required | Notes                                                           |
| ------- | ------ | -------- | --------------------------------------------------------------- |
| `jobId` | string | yes      | Identifier of the job returned by its create or list operation. |

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## get\_target\_history

List paginated saved destination-health observations, independently of source-link presence.

* **State**: Registered and locally tested.
* **Access**: read · scope: `watches:read` · defined at `src/tool-registry.js:98`

| Input      | Type    | Required | Notes                                                                       |
| ---------- | ------- | -------- | --------------------------------------------------------------------------- |
| `targetId` | string  | yes      | Identifier of the target returned by its create or list operation.          |
| `cursor`   | string  | no       | Opaque continuation returned by this same listing; omit for the first page. |
| `limit`    | integer | no       | Maximum rows in this page or bounded report; subject to the schema maximum. |

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## get\_target\_placements

List placements whose configured target URL exactly matches this destination. Other URLs matched by a domain/path watch are not included.

* **State**: Registered and locally tested.
* **Access**: read · scope: `watches:read` · defined at `src/tool-registry.js:99`

| Input      | Type    | Required | Notes                                                                       |
| ---------- | ------- | -------- | --------------------------------------------------------------------------- |
| `targetId` | string  | yes      | Identifier of the target returned by its create or list operation.          |
| `cursor`   | string  | no       | Opaque continuation returned by this same listing; omit for the first page. |
| `limit`    | integer | no       | Maximum rows in this page or bounded report; subject to the schema maximum. |

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`

## list\_target\_events

Read the independent destination-health event feed. Its cursor is separate from link events; a broken destination does not imply that its source backlink disappeared.

* **State**: Registered and locally tested.
* **Access**: read · scope: `events:read` · defined at `src/tool-registry.js:100`

| Input       | Type    | Required | Notes                                                                       |
| ----------- | ------- | -------- | --------------------------------------------------------------------------- |
| `cursor`    | string  | no       | Opaque continuation returned by this same listing; omit for the first page. |
| `limit`     | integer | no       | Maximum rows in this page or bounded report; subject to the schema maximum. |
| `projectId` | string  | no       | Identifier of the project returned by its create or list operation.         |

**Error codes**: `CHECK_COOLDOWN` · `CURSOR_EXPIRED` · `IDEMPOTENCY_CONFLICT` · `INVALID_CADENCE` · `INVALID_CURSOR` · `INVALID_IDEMPOTENCY_KEY` · `INVALID_INPUT` · `INVALID_LIMIT` · `INVALID_STATUS` · `INVALID_TARGET_ID` · `INVALID_UPDATE` · `JOB_NOT_FOUND` · `TARGET_BUSY` · `TARGET_NOT_FOUND` · `TARGET_PAUSED` · `TARGET_QUOTA_EXCEEDED`