{"id":"linked-art/canonical-identifier-policy","relativePath":"linked-art/canonical-identifier-policy.md","title":"Canonical Identifier Policy","markdown":"# Canonical Identifier Policy\n\nStatus: active public-data policy\nLast updated: 2026-07-05\nOwner: Meta Museum data stewardship\n\n## Scope\n\nThis policy covers public Meta Museum Linked Art record identifiers, dataset\nexports, dereferenceable API URLs, and persistent resolver strategy. It exists\nso partners can reuse records without guessing whether identifiers are stable,\nwhat redirects mean, or when a static dataset release should receive a stronger\nexternal identifier.\n\n## Canonical URI Pattern\n\nCanonical Meta Museum identifiers use:\n\n```text\nhttps://lod.metamuseum.org/{type}/{ulid}\n```\n\nSource-provider URLs, Wikidata QIDs, ARKs, and other upstream identifiers are\nmodeled as equivalents, source ids, or identifiers. They are not silently\nsubstituted for the Meta Museum canonical id.\n\n## Persistence Promise\n\nStable canonical ids are intended to persist for the life of the public dataset.\nIdentifiers are never recycled for unrelated objects. If a record is superseded,\nmerged, withdrawn, or removed because a source provider returns a legitimate\n404/410 tombstone, Meta Museum should preserve an explicit redirect,\nreplacement, or tombstone trail rather than silently deleting the meaning of the\nidentifier.\n\n## Dereferencing And Redirects\n\nPublic record URLs should resolve to the current canonical JSON-LD record when\nthe record is active. If a record has moved, HTTP redirects should point to the\nreplacement. If a record is legitimately deleted upstream, the ActivityStreams\nDelete/Tombstone evidence path should be used and the public surface should make\nthe removal state explicit.\n\n## Content Negotiation\n\nPublic record APIs support JSON and Linked Art JSON-LD reads. HTML pages expose\none canonical `describedby` link to their JSON-LD endpoint. Partners should use\n`Accept: application/ld+json` when they need Linked Art JSON-LD and should treat\nHAL links as navigation metadata, not graph assertions.\n\n## Dataset Exports\n\nMachine-readable dataset metadata is published at `/api/datasets`. Versioned\nrecord exports are available at:\n\n- `/api/datasets/exports/records?format=jsonld`\n- `/api/datasets/exports/records?format=ndjson`\n\nEach export version includes a checksum. Each exported row preserves the Linked\nArt record body and adds a packaging envelope for record-level rights and source\nprovenance. Exported records project object-level `equivalent[]` links from\nstored equivalents, source provider URLs, provider public object pages, and\nWikidata entity URLs so consumers can reconcile through the standard Linked Art\npath instead of digging into `_source` passthrough fields. Missing rights remain\nreview-required and non-reuse by default.\n\nThe dataset-level CC BY 4.0 license governs Meta Museum's export packaging,\nmetadata envelope, and dataset descriptor. Individual object/content/media reuse\nis still governed by each row's record-level rights and source provenance; a\nper-record CC0 right does not turn the entire export package into CC0, and the\ndataset package license does not override stricter object/media rights.\n\n## ARK And DOI Strategy\n\nARKs are appropriate for object-level public resolver needs where an opaque,\nlong-lived identifier helps partners cite a record independently of source\nprovider URLs. DOI registration is reserved for curated static dataset releases\nwith fixed scope, declared license, release notes, and checksum, not for every\nrolling API snapshot.\n\n## Partner Evidence Boundary\n\nIdentifier stability and export availability are local Meta Museum commitments.\nExternal adoption evidence is counted only when a real partner reads or verifies\nthe relevant public surface. MetaHistoryBook has confirmed real Update coverage;\nDelete coverage still waits for a legitimate upstream 404/410 tombstone and must\nnot be fabricated.\n","sections":[{"level":2,"heading":"Scope","anchor":"scope"},{"level":2,"heading":"Canonical URI Pattern","anchor":"canonical-uri-pattern"},{"level":2,"heading":"Persistence Promise","anchor":"persistence-promise"},{"level":2,"heading":"Dereferencing And Redirects","anchor":"dereferencing-and-redirects"},{"level":2,"heading":"Content Negotiation","anchor":"content-negotiation"},{"level":2,"heading":"Dataset Exports","anchor":"dataset-exports"},{"level":2,"heading":"ARK And DOI Strategy","anchor":"ark-and-doi-strategy"},{"level":2,"heading":"Partner Evidence Boundary","anchor":"partner-evidence-boundary"}],"html":"<h1 id=\"canonical-identifier-policy\">Canonical Identifier Policy</h1>\n<p>Status: active public-data policy</p>\n<p>Last updated: 2026-07-05</p>\n<p>Owner: Meta Museum data stewardship</p>\n<h2 id=\"scope\">Scope</h2>\n<p>This policy covers public Meta Museum Linked Art record identifiers, dataset</p>\n<p>exports, dereferenceable API URLs, and persistent resolver strategy. It exists</p>\n<p>so partners can reuse records without guessing whether identifiers are stable,</p>\n<p>what redirects mean, or when a static dataset release should receive a stronger</p>\n<p>external identifier.</p>\n<h2 id=\"canonical-uri-pattern\">Canonical URI Pattern</h2>\n<p>Canonical Meta Museum identifiers use:</p>\n<pre><code>\nhttps://lod.metamuseum.org/{type}/{ulid}\n</code></pre>\n<p>Source-provider URLs, Wikidata QIDs, ARKs, and other upstream identifiers are</p>\n<p>modeled as equivalents, source ids, or identifiers. They are not silently</p>\n<p>substituted for the Meta Museum canonical id.</p>\n<h2 id=\"persistence-promise\">Persistence Promise</h2>\n<p>Stable canonical ids are intended to persist for the life of the public dataset.</p>\n<p>Identifiers are never recycled for unrelated objects. If a record is superseded,</p>\n<p>merged, withdrawn, or removed because a source provider returns a legitimate</p>\n<p>404/410 tombstone, Meta Museum should preserve an explicit redirect,</p>\n<p>replacement, or tombstone trail rather than silently deleting the meaning of the</p>\n<p>identifier.</p>\n<h2 id=\"dereferencing-and-redirects\">Dereferencing And Redirects</h2>\n<p>Public record URLs should resolve to the current canonical JSON-LD record when</p>\n<p>the record is active. If a record has moved, HTTP redirects should point to the</p>\n<p>replacement. If a record is legitimately deleted upstream, the ActivityStreams</p>\n<p>Delete/Tombstone evidence path should be used and the public surface should make</p>\n<p>the removal state explicit.</p>\n<h2 id=\"content-negotiation\">Content Negotiation</h2>\n<p>Public record APIs support JSON and Linked Art JSON-LD reads. HTML pages expose</p>\n<p>one canonical `describedby` link to their JSON-LD endpoint. Partners should use</p>\n<p>`Accept: application/ld+json` when they need Linked Art JSON-LD and should treat</p>\n<p>HAL links as navigation metadata, not graph assertions.</p>\n<h2 id=\"dataset-exports\">Dataset Exports</h2>\n<p>Machine-readable dataset metadata is published at `/api/datasets`. Versioned</p>\n<p>record exports are available at:</p>\n<ul><li>`/api/datasets/exports/records?format=jsonld`</li><li>`/api/datasets/exports/records?format=ndjson`</li></ul>\n<p>Each export version includes a checksum. Each exported row preserves the Linked</p>\n<p>Art record body and adds a packaging envelope for record-level rights and source</p>\n<p>provenance. Exported records project object-level `equivalent[]` links from</p>\n<p>stored equivalents, source provider URLs, provider public object pages, and</p>\n<p>Wikidata entity URLs so consumers can reconcile through the standard Linked Art</p>\n<p>path instead of digging into `_source` passthrough fields. Missing rights remain</p>\n<p>review-required and non-reuse by default.</p>\n<p>The dataset-level CC BY 4.0 license governs Meta Museum&#39;s export packaging,</p>\n<p>metadata envelope, and dataset descriptor. Individual object/content/media reuse</p>\n<p>is still governed by each row&#39;s record-level rights and source provenance; a</p>\n<p>per-record CC0 right does not turn the entire export package into CC0, and the</p>\n<p>dataset package license does not override stricter object/media rights.</p>\n<h2 id=\"ark-and-doi-strategy\">ARK And DOI Strategy</h2>\n<p>ARKs are appropriate for object-level public resolver needs where an opaque,</p>\n<p>long-lived identifier helps partners cite a record independently of source</p>\n<p>provider URLs. DOI registration is reserved for curated static dataset releases</p>\n<p>with fixed scope, declared license, release notes, and checksum, not for every</p>\n<p>rolling API snapshot.</p>\n<h2 id=\"partner-evidence-boundary\">Partner Evidence Boundary</h2>\n<p>Identifier stability and export availability are local Meta Museum commitments.</p>\n<p>External adoption evidence is counted only when a real partner reads or verifies</p>\n<p>the relevant public surface. MetaHistoryBook has confirmed real Update coverage;</p>\n<p>Delete coverage still waits for a legitimate upstream 404/410 tombstone and must</p>\n<p>not be fabricated.</p>","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"56bc7bc9ee2fb87f2f687fba9ebe08f5f9ff1de803e7fd862335f750e36d9951","checksumPrefix":"56bc7bc9ee2f","anchorCount":8,"lineCount":88,"rawUrl":"/api/docs/content?path=linked-art%2Fcanonical-identifier-policy.md","htmlUrl":"/docs?doc=linked-art%2Fcanonical-identifier-policy.md","apiUrl":"/api/docs/content?path=linked-art%2Fcanonical-identifier-policy.md"}