> ## 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.

# Reevaluate admission

> Report how current rules classify retained watches or candidates.

`reevaluate_admission`

Report how current rules classify retained watches or candidates. Never changes records or requests checks; per-import domain caps do not apply.

<Note>Available in the deployed MCP and HTTP bundle. Confirm access and inputs with your connected catalog. Workspace scopes and enabled providers still apply.</Note>

| Access           | Behavior         |
| ---------------- | ---------------- |
| `discovery:read` | Reads saved data |

This read does not start a verification job.

## Example request

Connect through [MCP](/guides/connect-mcp), [CLI](/guides/connect-cli), or [HTTP](/guides/connect-http). Replace example identifiers with records from your workspace.

<CodeGroup>
  ```json MCP theme={null}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "reevaluate_admission",
      "arguments": {
        "projectId": "project_example",
        "source": "watches",
        "limit": 50
      }
    }
  }
  ```

  ```bash CLI theme={null}
  agentlinkops call reevaluate_admission --args '{"projectId":"project_example","source":"watches","limit":50}'
  ```

  ```bash HTTP theme={null}
  curl "$AGENTLINKOPS_API_URL/v1/commands/reevaluate_admission" \
    -H "Authorization: Bearer $AGENTLINKOPS_API_KEY" \
    -H 'Content-Type: application/json' \
    --data '{"projectId":"project_example","source":"watches","limit":50}'
  ```
</CodeGroup>

## Returned result

Illustrative data validated against the documented response schema. IDs and dates are examples, not a live account capture. MCP returns this data in `structuredContent` and in a text content block; generic HTTP and CLI return the JSON result directly.

```json theme={null}
{
  "project_id": "project_example",
  "source": "watches",
  "rows": [],
  "page_summary": {
    "total": 0,
    "admitted": 0,
    "rejected": 0,
    "by_rule": {}
  },
  "policy_revision": 0,
  "disavow_revision": 0,
  "next_cursor": null,
  "has_more": false,
  "report_only": true,
  "snapshot": false,
  "domain_cap_applied": false
}
```

## Input fields

Omit optional fields when you do not want to supply them. Null is accepted only where listed. Unknown input properties are rejected.

| Field       | Type    | Presence | Meaning and constraints                                                                                   |
| ----------- | ------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `projectId` | string  | Required | Identifier of the project returned by its create or list operation. minLength: 1; maxLength: 200          |
| `source`    | string  | Required | The source value; allowed values and bounds are specified in this schema. values: "watches", "candidates" |
| `limit`     | integer | Optional | Maximum rows in this page or bounded report; subject to the schema maximum. minimum: 1; maximum: 100      |
| `cursor`    | string  | Optional | Opaque continuation returned by this same listing; omit for the first page. maxLength: 1024               |

### Validation and omitted values

Current policy applies before durable import or candidate work. Rejected rows retain their reason and original row identity.

Evaluation and retained-record reevaluation do not mutate records. Report pages do not apply whole-import domain caps; a changed policy requires restarting pagination. Historical receipts describe the original operation, not permission for new work.

## Output fields

Fields inside optional or nullable parents apply only when that parent exists. [Common schema conventions](/reference/schemas) explain evidence states, empty lists and extensions.

* **`project_id`** (string, required): Project that owns this record. minLength: 1; maxLength: 200
* **`source`** (string, required): values: "watches", "candidates"
* **`rows`** (array, required).
* **`page_summary`** (object, required): additional fields rejected
* **`policy_revision`** (integer, required): minimum: 0; maximum: 9007199254740991
* **`disavow_revision`** (integer, required): minimum: 0; maximum: 9007199254740991
* **`next_cursor`** (string / null, required): Opaque continuation for the same listing; null means no further page.
* **`has_more`** (boolean, required): True when another page is available.
* **`report_only`** (boolean, required): must equal true
* **`snapshot`** (boolean, required): must equal false
* **`domain_cap_applied`** (boolean, required): must equal false

<Accordion title="All fields and nested objects">
  | Field                            | Type          | Presence | Meaning and constraints                                                    |
  | -------------------------------- | ------------- | -------- | -------------------------------------------------------------------------- |
  | `project_id`                     | string        | Required | Project that owns this record. minLength: 1; maxLength: 200                |
  | `source`                         | string        | Required | values: "watches", "candidates"                                            |
  | `rows`                           | array         | Required |                                                                            |
  | `rows[].subject_id`              | string        | Required | Identifier returned by the related operation. minLength: 1; maxLength: 200 |
  | `rows[].decision`                | object        | Required | additional fields rejected                                                 |
  | `rows[].decision.index`          | integer       | Required | minimum: 0; maximum: 9007199254740991                                      |
  | `rows[].decision.url`            | string        | Required |                                                                            |
  | `rows[].decision.normalized_url` | string / null | Required |                                                                            |
  | `rows[].decision.host`           | string / null | Required |                                                                            |
  | `rows[].decision.decision`       | string        | Required | values: "admitted", "rejected"                                             |
  | `rows[].decision.reason`         | string        | Required | Recorded explanation; null when no explanation applies.                    |
  | `rows[].decision.rule_kind`      | string / null | Required |                                                                            |
  | `rows[].decision.rule_id`        | string / null | Required | Identifier returned by the related operation.                              |
  | `rows[].decision.rule_value`     | string / null | Required |                                                                            |
  | `rows[].decision.cap`            | object / null | Required |                                                                            |
  | `rows[].decision.cap.limit`      | integer       | Required | maximum: 9007199254740991; exclusiveMinimum: 0                             |
  | `rows[].decision.cap.used`       | integer       | Required | minimum: 0; maximum: 9007199254740991                                      |
  | `page_summary`                   | object        | Required | additional fields rejected                                                 |
  | `page_summary.total`             | integer       | Required | minimum: -9007199254740991; maximum: 9007199254740991                      |
  | `page_summary.admitted`          | integer       | Required | minimum: -9007199254740991; maximum: 9007199254740991                      |
  | `page_summary.rejected`          | integer       | Required | minimum: -9007199254740991; maximum: 9007199254740991                      |
  | `page_summary.by_rule`           | object        | Required |                                                                            |
  | `policy_revision`                | integer       | Required | minimum: 0; maximum: 9007199254740991                                      |
  | `disavow_revision`               | integer       | Required | minimum: 0; maximum: 9007199254740991                                      |
  | `next_cursor`                    | string / null | Required | Opaque continuation for the same listing; null means no further page.      |
  | `has_more`                       | boolean       | Required | True when another page is available.                                       |
  | `report_only`                    | boolean       | Required | must equal true                                                            |
  | `snapshot`                       | boolean       | Required | must equal false                                                           |
  | `domain_cap_applied`             | boolean       | Required | must equal false                                                           |
</Accordion>

[Download input schema](/schemas/reevaluate_admission.input.json) · [Download output schema](/schemas/reevaluate_admission.output.json)

## Errors and retries

The command is annotated idempotent. Reuse an accepted idempotency key when the input provides one; changing the payload under a reused key can conflict.

See [error recovery](/reference/errors) for status, scope, cooldown, cursor and retry handling. Unknown observations are result data and do not establish loss.

## HTTP resource routes

This operation has no separate resource alias. Use its generic command route in a matching environment.

## Continue

[evaluate\_admission](/reference/commands/evaluate_admission) · [get\_admission\_decisions](/reference/commands/get_admission_decisions)

Follow the [related workflow](/guides/import-and-verify), inspect [capability status](/capability-status), or return to the [command index](/reference/index).