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

# Import disavow rules

> Import a Google-format disavow file as inert proposals.

`import_disavow_rules`

Import a Google-format disavow file as inert proposals. Existing rules are not replaced; human approval is required before export.

<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              |
| --------------- | --------------------- |
| `watches:write` | Writes or admits work |

This operation changes saved state. Review its inputs and retry behavior before calling.

## 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": "import_disavow_rules",
      "arguments": {
        "projectId": "project_example",
        "text": "domain:spam.example.org\n"
      }
    }
  }
  ```

  ```bash CLI theme={null}
  agentlinkops call import_disavow_rules --args '{"projectId":"project_example","text":"domain:spam.example.org\n"}'
  ```

  ```bash HTTP theme={null}
  curl "$AGENTLINKOPS_API_URL/v1/commands/import_disavow_rules" \
    -H "Authorization: Bearer $AGENTLINKOPS_API_KEY" \
    -H 'Content-Type: application/json' \
    --data '{"projectId":"project_example","text":"domain:spam.example.org\n"}'
  ```
</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}
{
  "rules": [
    {
      "id": "dis_example",
      "workspace_id": "workspace_example",
      "project_id": "project_example",
      "kind": "domain",
      "value": "spam.example",
      "identity": "spam.example",
      "source": "import",
      "status": "proposed",
      "comments": [],
      "revision": 1,
      "created_by": "user_example",
      "approved_by": null,
      "created_at": "2026-09-20T00:00:00.000Z",
      "updated_at": "2026-09-20T00:00:00.000Z"
    }
  ],
  "created": 1,
  "unchanged": 0,
  "revision": 1
}
```

## 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 |
| `text`      | string | Required | The text value; allowed values and bounds are specified in this schema. maxLength: 163840        |

### Validation and omitted values

Proposals are inert until a human owner or administrator approves them. Agent credentials cannot approve, reject or delete rules.

Export records deterministic active-rule content and its hash; it never submits a file to Google.

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

* **`rules`** (array, required).
* **`created`** (integer, required): True when this request created the record; false when an existing record was reused. minimum: 0; maximum: 9007199254740991
* **`unchanged`** (integer, required): minimum: 0; maximum: 9007199254740991
* **`revision`** (integer, required): Optimistic concurrency revision; supply it as expectedRevision on the next write. minimum: 0; maximum: 9007199254740991

<Accordion title="All fields and nested objects">
  | Field                  | Type          | Presence | Meaning and constraints                                                                                                          |
  | ---------------------- | ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
  | `rules`                | array         | Required |                                                                                                                                  |
  | `rules[].id`           | string        | Required | Resource identifier returned by the operation. minLength: 1; maxLength: 200                                                      |
  | `rules[].workspace_id` | string        | Required | Workspace that owns this record. minLength: 1; maxLength: 200                                                                    |
  | `rules[].project_id`   | string        | Required | Project that owns this record. minLength: 1; maxLength: 200                                                                      |
  | `rules[].kind`         | string        | Required | values: "domain", "url"                                                                                                          |
  | `rules[].value`        | string        | Required |                                                                                                                                  |
  | `rules[].identity`     | string        | Required |                                                                                                                                  |
  | `rules[].source`       | string        | Required | values: "manual", "import", "agent\_proposal"                                                                                    |
  | `rules[].status`       | string        | Required | Resource lifecycle status. values: "proposed", "active", "rejected"                                                              |
  | `rules[].comments`     | array         | Required | maxItems: 8                                                                                                                      |
  | `rules[].revision`     | integer       | Required | Optimistic concurrency revision; supply it as expectedRevision on the next write. maximum: 9007199254740991; exclusiveMinimum: 0 |
  | `rules[].created_by`   | string        | Required | minLength: 1; maxLength: 200                                                                                                     |
  | `rules[].approved_by`  | string / null | Required |                                                                                                                                  |
  | `rules[].created_at`   | string        | Required | UTC timestamp when the record was created.                                                                                       |
  | `rules[].updated_at`   | string        | Required | UTC timestamp of the last record update.                                                                                         |
  | `created`              | integer       | Required | True when this request created the record; false when an existing record was reused. minimum: 0; maximum: 9007199254740991       |
  | `unchanged`            | integer       | Required | minimum: 0; maximum: 9007199254740991                                                                                            |
  | `revision`             | integer       | Required | Optimistic concurrency revision; supply it as expectedRevision on the next write. minimum: 0; maximum: 9007199254740991          |
</Accordion>

[Download input schema](/schemas/import_disavow_rules.input.json) · [Download output schema](/schemas/import_disavow_rules.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. Operation-specific errors include `INVALID_DISAVOW_INPUT`, `HUMAN_ADMIN_REQUIRED`, `DISAVOW_NOT_READY`, `DISAVOW_REVISION_CONFLICT`, `DISAVOW_RULE_NOT_FOUND`, `DISAVOW_RULE_CONFLICT`, `DISAVOW_SCOPE_CLOSED`, `DISAVOW_CAPACITY`, `DISAVOW_EXPORT_CAPACITY`, `DISAVOW_IMPORT_TOO_LARGE`, `DISAVOW_RULE_TOO_LARGE`, `INVALID_CURSOR`.

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

[list\_disavow\_rules](/reference/commands/list_disavow_rules) · [list\_disavow\_exports](/reference/commands/list_disavow_exports)

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