ApplicantMay change state

# Review Offer Comparison

`review_offer_comparison`

Save a private reviewed preference, reasons and unsent negotiation requests against current offer versions. A preference is not an acceptance or rejection. No employer communication occurs.

Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.

## Parameters

| Name | Contract |
| --- | --- |
| `id` Required | string |
| `expected_version` Required | integer |
| `preferred_offer_id` Required | See schema |
| `reasons` Required | string |
| `negotiation_requests` Optional | array |

## Exact input schema

Expand JSON Schema

```
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    },
    "expected_version": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "preferred_offer_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[a-zA-Z0-9_-]{1,100}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "reasons": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "negotiation_requests": {
      "default": [],
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    }
  },
  "required": [
    "id",
    "expected_version",
    "preferred_offer_id",
    "reasons"
  ],
  "additionalProperties": false
}
```

## Output schema

Expand output contract

```
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {}
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}
```

## Tool annotations

```
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": false
}
```

[← All applicant tools](/docs/tools?role=applicant) · [Review and receipts](/docs/review)
