← Tool reference

decide_listing_reconciliation

Decide on rechecked listing

Apply the buyer's decision on one pending listing reconciliation. accept adopts the rechecked listing values into the draft (or, for a listing the source now reports as pending, sold, or off market, records the buyer's acknowledgement that they want to continue anyway); reject keeps the saved values and pauses the workspace until the listing is rechecked again. Show the buyer the differences and the returned notice and ask them in this conversation first; only their answer here counts. A result whose decisions offer neither choice is a stop the product itself enforces, never something to work around. Internal to Ohvii: it contacts nobody and sends nothing.

Effect
Consequential change
Required scopes
workspace:write
Workflow stages
offer, research
Data classes
property listing
Operation cost
3 weighted units; additional domain limits may apply.
Configurations
Standard, Buyer UI v2
Muse proposal
Sensitive write. Changes or removes a record, recipient, or permission the buyer relies on. Meta makes the final classification during review.

Buyer approval and signing controls apply in addition to the scopes above. Read error and retry guidance before implementing recovery.

Input and output contracts

Returns structured content and a JSON text content block. Live discovery may compact a large output schema; execution validates the full contract below.

Input fields

Required applies within the containing object. Optional fields can be omitted; null is accepted only where listed. Field descriptions and constraints come from the source schema. The raw schema remains the complete contract.

FieldRequiredMeaning and constraints
decisionstringYes

Allowed: "accept", "reject".

reconciliationIdstringYes

Format: uuid.

Pattern validation applies; see the raw schema.

workspaceIdstringYes

Format: uuid.

Pattern validation applies; see the raw schema.

Output fields

Required applies within the containing object. Optional fields can be omitted; null is accepted only where listed. Field descriptions and constraints come from the source schema. The raw schema remains the complete contract.

FieldRequiredMeaning and constraints
decisionstringYes

Allowed: "accepted", "rejected".

draftRevisionintegerYes

Maximum: 9007199254740991.

Greater than: 0.

freshnessobjectYes

Extra fields are not allowed.

freshness: nested contract
FieldRequiredMeaning and constraints
blockingReasonsarray<string>Yes

Maximum items: 10.

blockingReasons: nested contract
Array item contract

Allowed: "buyer_rejected_changes", "claim_withdrawn", "identity_changed", "listing_inactive", "listing_unavailable".

claimVerifiedAtstring | nullYes

Must match at least one alternative.

claimVerifiedAt: nested contract
Alternative 1: string

Format: date-time. Pattern validation applies; see the raw schema.

Alternative 2: null

compVerifiedAtstring | nullYes

Must match at least one alternative.

compVerifiedAt: nested contract
Alternative 1: string

Format: date-time. Pattern validation applies; see the raw schema.

Alternative 2: null

listingVerifiedAtstring | nullYes

Must match at least one alternative.

listingVerifiedAt: nested contract
Alternative 1: string

Format: date-time. Pattern validation applies; see the raw schema.

Alternative 2: null

nextRefreshAtstring | nullYes

Must match at least one alternative.

nextRefreshAt: nested contract
Alternative 1: string

Format: date-time. Pattern validation applies; see the raw schema.

Alternative 2: null

pausedbooleanYesNo additional description in the contract.
pauseSentencestring | nullYes

Must match at least one alternative.

pauseSentence: nested contract
Alternative 1: string

Maximum characters: 1000.

Alternative 2: null

pendingReconciliationobject | nullYes

Must match at least one alternative.

pendingReconciliation: nested contract
Alternative 1: object

Extra fields are not allowed.

FieldRequiredMeaning and constraints
blockingReasonsarray<string>Yes

Maximum items: 10.

blockingReasons: nested contract
Array item contract

Allowed: "buyer_rejected_changes", "claim_withdrawn", "identity_changed", "listing_inactive", "listing_unavailable".

candidateListingStatusstring | nullYes

Must match at least one alternative.

candidateListingStatus: nested contract
Alternative 1: string

Maximum characters: 120.

Alternative 2: null

decisionsobjectYes

Extra fields are not allowed.

decisions: nested contract
FieldRequiredMeaning and constraints
acceptbooleanYesNo additional description in the contract.
rejectbooleanYesNo additional description in the contract.
severitystringYes

Allowed: "none", "stop", "warn".

diffsarray<object>Yes

Maximum items: 20.

diffs: nested contract
Array item contract

Extra fields are not allowed.

FieldRequiredMeaning and constraints
blockingbooleanYesNo additional description in the contract.
currentValuestring | number | boolean | null | array<string | number | boolean | null | array<string | number | boolean | null | array<string | number | boolean | null | array<string | number | boolean | null | array<reference (see JSON)> | object> | object> | object> | object> | objectYes

Must match at least one alternative.

currentValue: nested contract

Further nesting is available in the raw schema below.

fieldstringYes

Allowed: "claim_contact", "claim_documents", "claim_resource_links", "claim_status", "comps", "escrow_preference", "listing_agent", "listing_status", "list_price", "offer_deadline", "property_identity", "submission_instructions".

previousValuestring | number | boolean | null | array<string | number | boolean | null | array<string | number | boolean | null | array<string | number | boolean | null | array<string | number | boolean | null | array<reference (see JSON)> | object> | object> | object> | object> | objectYes

Must match at least one alternative.

previousValue: nested contract

Further nesting is available in the raw schema below.

idstringYes

Format: uuid.

Pattern validation applies; see the raw schema.

noticestring | nullYes

Must match at least one alternative.

notice: nested contract
Alternative 1: string

Maximum characters: 1000.

Alternative 2: null

observedAtstringYes

Format: date-time.

Pattern validation applies; see the raw schema.

statusstringYes

Allowed: "accepted", "blocked", "no_change", "pending", "rejected", "superseded".

Alternative 2: null

refreshSupportedbooleanYesNo additional description in the contract.
stalebooleanYesNo additional description in the contract.
staleReasonsarray<string>Yes

Maximum items: 10.

staleReasons: nested contract
Array item contract

Allowed: "claim_check_expired", "comp_check_expired", "comp_listing_mismatch", "listing_check_expired", "never_verified", "reconciliation_blocked", "reconciliation_required".

statusstringYes

Allowed: "blocked", "current", "review_required", "stale".

reconciliationIdstringYes

Format: uuid.

Pattern validation applies; see the raw schema.

schemaVersionstringYes

Must be "1".

workspaceIdstringYes

Format: uuid.

Pattern validation applies; see the raw schema.

Raw input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "decision": {
      "type": "string",
      "enum": [
        "accept",
        "reject"
      ]
    },
    "reconciliationId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "decision",
    "reconciliationId",
    "workspaceId"
  ],
  "additionalProperties": false
}
Full output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "decision": {
      "type": "string",
      "enum": [
        "accepted",
        "rejected"
      ]
    },
    "draftRevision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "freshness": {
      "type": "object",
      "properties": {
        "blockingReasons": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "buyer_rejected_changes",
              "claim_withdrawn",
              "identity_changed",
              "listing_inactive",
              "listing_unavailable"
            ]
          }
        },
        "claimVerifiedAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "compVerifiedAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "listingVerifiedAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "nextRefreshAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "paused": {
          "type": "boolean"
        },
        "pauseSentence": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "pendingReconciliation": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "blockingReasons": {
                  "maxItems": 10,
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "buyer_rejected_changes",
                      "claim_withdrawn",
                      "identity_changed",
                      "listing_inactive",
                      "listing_unavailable"
                    ]
                  }
                },
                "candidateListingStatus": {
                  "anyOf": [
                    {
                      "type": "string",
                      "maxLength": 120
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "decisions": {
                  "type": "object",
                  "properties": {
                    "accept": {
                      "type": "boolean"
                    },
                    "reject": {
                      "type": "boolean"
                    },
                    "severity": {
                      "type": "string",
                      "enum": [
                        "none",
                        "stop",
                        "warn"
                      ]
                    }
                  },
                  "required": [
                    "accept",
                    "reject",
                    "severity"
                  ],
                  "additionalProperties": false
                },
                "diffs": {
                  "maxItems": 20,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "blocking": {
                        "type": "boolean"
                      },
                      "currentValue": {
                        "$ref": "#/$defs/__schema0"
                      },
                      "field": {
                        "type": "string",
                        "enum": [
                          "claim_contact",
                          "claim_documents",
                          "claim_resource_links",
                          "claim_status",
                          "comps",
                          "escrow_preference",
                          "listing_agent",
                          "listing_status",
                          "list_price",
                          "offer_deadline",
                          "property_identity",
                          "submission_instructions"
                        ]
                      },
                      "previousValue": {
                        "$ref": "#/$defs/__schema0"
                      }
                    },
                    "required": [
                      "blocking",
                      "currentValue",
                      "field",
                      "previousValue"
                    ],
                    "additionalProperties": false
                  }
                },
                "id": {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                },
                "notice": {
                  "anyOf": [
                    {
                      "type": "string",
                      "maxLength": 1000
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "observedAt": {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "accepted",
                    "blocked",
                    "no_change",
                    "pending",
                    "rejected",
                    "superseded"
                  ]
                }
              },
              "required": [
                "blockingReasons",
                "candidateListingStatus",
                "decisions",
                "diffs",
                "id",
                "notice",
                "observedAt",
                "status"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "refreshSupported": {
          "type": "boolean"
        },
        "stale": {
          "type": "boolean"
        },
        "staleReasons": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "claim_check_expired",
              "comp_check_expired",
              "comp_listing_mismatch",
              "listing_check_expired",
              "never_verified",
              "reconciliation_blocked",
              "reconciliation_required"
            ]
          }
        },
        "status": {
          "type": "string",
          "enum": [
            "blocked",
            "current",
            "review_required",
            "stale"
          ]
        }
      },
      "required": [
        "blockingReasons",
        "claimVerifiedAt",
        "compVerifiedAt",
        "listingVerifiedAt",
        "nextRefreshAt",
        "paused",
        "pauseSentence",
        "pendingReconciliation",
        "refreshSupported",
        "stale",
        "staleReasons",
        "status"
      ],
      "additionalProperties": false
    },
    "reconciliationId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "schemaVersion": {
      "type": "string",
      "const": "1"
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "decision",
    "draftRevision",
    "freshness",
    "reconciliationId",
    "schemaVersion",
    "workspaceId"
  ],
  "additionalProperties": false,
  "$defs": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 6000
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "maxItems": 100,
          "type": "array",
          "items": {
            "$ref": "#/$defs/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string",
            "maxLength": 80
          },
          "additionalProperties": {
            "$ref": "#/$defs/__schema0"
          }
        }
      ]
    }
  }
}
Tool annotations
{
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false,
  "readOnlyHint": false
}

Reference 00e5441a095c7e20. Download the full catalog.