# com.tituslegaldesign.immigration.dispute

> Published by [287g-data.tituslegaldesign.com](https://lexicon.garden/identity/did:plc:2wxsvrr5qgqwxy53ebo4kqet)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:2wxsvrr5qgqwxy53ebo4kqet/com.tituslegaldesign.immigration.dispute)
- [Documentation](https://lexicon.garden/lexicon/did:plc:2wxsvrr5qgqwxy53ebo4kqet/com.tituslegaldesign.immigration.dispute/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:2wxsvrr5qgqwxy53ebo4kqet/com.tituslegaldesign.immigration.dispute/examples)

## Definitions

### `com.tituslegaldesign.immigration.dispute`

**Type**: `record`

A contested claim about a 287(g) agreement record. Written into the DISPUTING PARTY'S OWN repository, not the publisher's, and referencing the disputed record by AT-URI and CID. Anyone may publish one: the agreement's publisher need not consent and cannot suppress it. Consumers find disputes by querying com.atproto.sync.listReposByCollection for this collection and following the subject URIs. Record key is a TID.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `assertedValue` | `string` | No | What the disputing party says the value should be. |
| `basis` | `string` | Yes | Why the record is contested. factual-error = the value is wrong; outdated = it was right and no longer is; disputed-interpretation = the underlying facts are agreed but their characterization is not; missing-context = not false but materially incomplete; superseded = a later agreement replaced this one. |
| `createdAt` | `string` (datetime) | Yes | When this dispute was filed. |
| `disputantRole` | `string` | No | Self-declared relationship of the disputing party to the record. Self-declared: consumers should not treat it as verified. |
| `evidence` | `array` | No | Supporting documents, archived as content-addressed blobs in the disputing party's own repository. |
| `field` | `string` | No | Which agreement-record field is contested, when the dispute is field-specific. Absent for disputes about the record as a whole. |
| `resolvedBy` | `string` (at-uri) | No | Optionally set by the DISPUTING party once satisfied, pointing at the agreementEvent that addressed the dispute. Only the disputant can write this, since the record is in their repository. |
| `statement` | `string` | No | The disputing party's explanation, in their own words. |
| `subject` | `string` (at-uri) | Yes | AT URI of the disputed agreement record. |
| `subjectCid` | `string` (cid) | Yes | CID of the exact record version being disputed. A later correction by the publisher does not silently resolve this dispute; it leaves it attached to the version that was actually wrong. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A contested claim about a 287(g) agreement record. Written into the DISPUTING PARTY'S OWN repository, not the publisher's, and referencing the disputed record by AT-URI and CID. Anyone may publish one: the agreement's publisher need not consent and cannot suppress it. Consumers find disputes by querying com.atproto.sync.listReposByCollection for this collection and following the subject URIs. Record key is a TID.",
      "key": "tid",
      "record": {
        "properties": {
          "assertedValue": {
            "description": "What the disputing party says the value should be.",
            "maxLength": 3000,
            "type": "string"
          },
          "basis": {
            "description": "Why the record is contested. factual-error = the value is wrong; outdated = it was right and no longer is; disputed-interpretation = the underlying facts are agreed but their characterization is not; missing-context = not false but materially incomplete; superseded = a later agreement replaced this one.",
            "knownValues": [
              "factual-error",
              "outdated",
              "disputed-interpretation",
              "missing-context",
              "superseded"
            ],
            "type": "string"
          },
          "createdAt": {
            "description": "When this dispute was filed.",
            "format": "datetime",
            "type": "string"
          },
          "disputantRole": {
            "description": "Self-declared relationship of the disputing party to the record. Self-declared: consumers should not treat it as verified.",
            "knownValues": [
              "subject-agency",
              "government",
              "legal-representative",
              "journalist",
              "researcher",
              "other"
            ],
            "type": "string"
          },
          "evidence": {
            "description": "Supporting documents, archived as content-addressed blobs in the disputing party's own repository.",
            "items": {
              "ref": "com.tituslegaldesign.immigration.agreement#document",
              "type": "ref"
            },
            "maxLength": 10,
            "type": "array"
          },
          "field": {
            "description": "Which agreement-record field is contested, when the dispute is field-specific. Absent for disputes about the record as a whole.",
            "maxLength": 100,
            "type": "string"
          },
          "resolvedBy": {
            "description": "Optionally set by the DISPUTING party once satisfied, pointing at the agreementEvent that addressed the dispute. Only the disputant can write this, since the record is in their repository.",
            "format": "at-uri",
            "type": "string"
          },
          "statement": {
            "description": "The disputing party's explanation, in their own words.",
            "maxLength": 5000,
            "type": "string"
          },
          "subject": {
            "description": "AT URI of the disputed agreement record.",
            "format": "at-uri",
            "type": "string"
          },
          "subjectCid": {
            "description": "CID of the exact record version being disputed. A later correction by the publisher does not silently resolve this dispute; it leaves it attached to the version that was actually wrong.",
            "format": "cid",
            "type": "string"
          }
        },
        "required": [
          "subject",
          "subjectCid",
          "basis",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "com.tituslegaldesign.immigration.dispute",
  "lexicon": 1
}
```