com.tituslegaldesign.immigration.sourceSnapshot

A point-in-time capture of an upstream source publication: ICE's participating-agencies workbook, a FOIA production, or a roster PDF. Agreement events reference the snapshot that justified them, so every published change traces back to an archived, content-addressed copy of the document it came from. Record key is a TID. Snapshots are never updated or deleted; a revised upstream file is a new snapshot.

Details · record, key tid
Kindrecord
Record keytid
Authorityimmigration.tituslegaldesign.com
Indexed

Record

record · key tid

Properties

createdAt

requiredstring · datetime

When this snapshot record was written.

file

blob

The captured artifact itself. Its CID pins the exact bytes. Omit only when the artifact cannot be redistributed.

  • maxSize: 50000000
  • accept: application/pdf, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

Agency-assigned FOIA tracking number, when publisher is 'foia'.

  • maxLength: 100

note

string

Context: retrieval anomalies, known upstream errors, processing caveats.

  • maxLength: 3000

The edition date the upstream publisher assigned, YYYY-MM-DD, where stated on the artifact itself.

  • maxLength: 10

publisher

requiredstring

Who published the captured artifact. 'publisher' means this dataset's own maintainer produced it (e.g. a derived spreadsheet).

  • knownValues: ice | foia | publisher | other

retrievedAt

requiredstring · datetime

When the artifact was retrieved and archived.

rowCount

integer

Number of agreement rows the artifact contained, where countable. Lets consumers detect silent upstream shrinkage.

  • minimum: 0

sourceUrl

string · uri

Where the artifact was retrieved from, when it was published at a URL.

title

string

Human-readable description, e.g. 'ICE participating agencies workbook, 14 Aug 2026 edition'.

  • maxLength: 300

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A canonical public-interest document record. Represents one official publication, report, filing, act, submission, or other source document before structural parsing or AI enrichment.

  • An append-only changelog entry for a 287(g) agreement record. One event is written every time the sync detects a change: a new agreement, a cancellation, a field-level modification, or a data correction. Together these events form the public changelog that ICE's snapshot-only publishing omits. Record key is a TID (timestamp identifier); events are never updated or deleted. Events carry the CID of the agreement record version they describe, so a third party holding an older CAR export can verify