{"id":"linked-art/api/textual-works","relativePath":"linked-art/api/textual-works.md","title":"Linked Art API: Textual Works","markdown":"# Linked Art API: Textual Works\n\n**Last refreshed:** 2026-07-06\n\nSource: [Textual Works endpoint](https://linked.art/api/1.0/endpoint/textual_work/), part of Linked Art API 1.0, published under [CC BY 4.0](http://creativecommons.org/licenses/by/4.0/). This is a project summary; the upstream page is authoritative.\n\n## Purpose\n\nThe Textual Work endpoint describes linguistic content, such as text carried by printed or digital books, text incorporated into artworks, and other noteworthy textual content. It models the intellectual text as a `LinguisticObject`, separate from physical carriers such as books and digital carriers such as web pages or files.\n\nThis endpoint is related to the broader Document model, but its API concern is the dereferenceable JSON-LD description of the text itself.\n\n## Required Shape\n\nA Textual Work endpoint record dereferences to one JSON-LD object:\n\n- `@context`: Linked Art context URI, or an array ending with that URI for extensions.\n- `id`: dereferenceable HTTP(S) URI for the text.\n- `type`: `LinguisticObject`.\n\n## Recommended Fields\n\n- `_label`: developer-facing label.\n- `classified_as`: classifications following the `Type` structure, such as monograph or chapter.\n- `identified_by`: `Name` and/or `Identifier` structures, including titles and identifiers such as ISBNs.\n\n## Optional Fields\n\n- `referred_to_by`: statements about the text, such as abstracts.\n- `equivalent`: external identities.\n- `subject_of`: textual works about the current text.\n- `representation`: visual works representing the text.\n- `member_of`: set membership.\n- `attributed_by`: relationship assignment evidence.\n- `language`: languages expressed in the text.\n- `dimension`: dimensions such as total word count or page count.\n- `part_of`: another `LinguisticObject` or `VisualItem` that contains the text as a part.\n- `conceptually_part_of`: an `PropositionalObject` that the text is conceptually part of.\n- `content`: string representation of the textual content.\n- `format`: media type of the `content` string.\n- `about`: entities that the text is primarily about.\n- `subject_to`: rights held over the intellectual work.\n- `created_by`: `Creation` event for authorship or creation of the text.\n- `used_for`: publication or similar `Activity`.\n\n## Common Incoming Relationships\n\n- `subject_of` from any endpoint whose entity is the subject of textual content.\n- `carries` from a Physical Object, when a physical carrier such as a manuscript or book carries the text.\n- `digitally_carries` from a Digital Object, when a digital carrier such as a file or web page carries the text.\n\n## Meta Museum Notes\n\nMeta Museum already preserves Textual Work semantics through `/api/records/{id}` fixtures for the Textual Documents profile. Existing coverage proves physical book `HumanMadeObject` carriers link to `LinguisticObject` content through `carries`, textual records preserve monograph/chapter classifications, primary and system identifiers, language, `content`, authorship `Creation`, publishing `Activity`, object `about` references, abstract-work `part_of` links, pagination statements, page-count dimensions, and `digitally_carried_by` digital carriers without collapsing copy, text, and web page into one record.\n\n## Test Ideas\n\n- Preserve `LinguisticObject` role coverage for textual records through `/api/records/{id}` and any dedicated textual-work endpoint.\n- Preserve `language`, `content`, `format`, `about`, `part_of`, `conceptually_part_of`, and `subject_to`.\n- Preserve authorship as `created_by` `Creation`, not as a flattened string.\n- Preserve publication evidence as `used_for` `Activity` with place, actor, and timespan when present.\n- Preserve carrier boundaries: physical objects use `carries`, digital objects use `digitally_carries`, and the text remains a distinct `LinguisticObject`.\n","sections":[{"level":2,"heading":"Purpose","anchor":"purpose"},{"level":2,"heading":"Required Shape","anchor":"required-shape"},{"level":2,"heading":"Recommended Fields","anchor":"recommended-fields"},{"level":2,"heading":"Optional Fields","anchor":"optional-fields"},{"level":2,"heading":"Common Incoming Relationships","anchor":"common-incoming-relationships"},{"level":2,"heading":"Meta Museum Notes","anchor":"meta-museum-notes"},{"level":2,"heading":"Test Ideas","anchor":"test-ideas"}],"html":"<h1 id=\"linked-art-api-textual-works\">Linked Art API: Textual Works</h1>\n<p><strong>Last refreshed:</strong> 2026-07-06</p>\n<p>Source: <a href=\"https://linked.art/api/1.0/endpoint/textual_work/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">Textual Works endpoint</a>, part of Linked Art API 1.0, published under <a href=\"http://creativecommons.org/licenses/by/4.0/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">CC BY 4.0</a>. This is a project summary; the upstream page is authoritative.</p>\n<h2 id=\"purpose\">Purpose</h2>\n<p>The Textual Work endpoint describes linguistic content, such as text carried by printed or digital books, text incorporated into artworks, and other noteworthy textual content. It models the intellectual text as a `LinguisticObject`, separate from physical carriers such as books and digital carriers such as web pages or files.</p>\n<p>This endpoint is related to the broader Document model, but its API concern is the dereferenceable JSON-LD description of the text itself.</p>\n<h2 id=\"required-shape\">Required Shape</h2>\n<p>A Textual Work endpoint record dereferences to one JSON-LD object:</p>\n<ul><li>`@context`: Linked Art context URI, or an array ending with that URI for extensions.</li><li>`id`: dereferenceable HTTP(S) URI for the text.</li><li>`type`: `LinguisticObject`.</li></ul>\n<h2 id=\"recommended-fields\">Recommended Fields</h2>\n<ul><li>`_label`: developer-facing label.</li><li>`classified_as`: classifications following the `Type` structure, such as monograph or chapter.</li><li>`identified_by`: `Name` and/or `Identifier` structures, including titles and identifiers such as ISBNs.</li></ul>\n<h2 id=\"optional-fields\">Optional Fields</h2>\n<ul><li>`referred_to_by`: statements about the text, such as abstracts.</li><li>`equivalent`: external identities.</li><li>`subject_of`: textual works about the current text.</li><li>`representation`: visual works representing the text.</li><li>`member_of`: set membership.</li><li>`attributed_by`: relationship assignment evidence.</li><li>`language`: languages expressed in the text.</li><li>`dimension`: dimensions such as total word count or page count.</li><li>`part_of`: another `LinguisticObject` or `VisualItem` that contains the text as a part.</li><li>`conceptually_part_of`: an `PropositionalObject` that the text is conceptually part of.</li><li>`content`: string representation of the textual content.</li><li>`format`: media type of the `content` string.</li><li>`about`: entities that the text is primarily about.</li><li>`subject_to`: rights held over the intellectual work.</li><li>`created_by`: `Creation` event for authorship or creation of the text.</li><li>`used_for`: publication or similar `Activity`.</li></ul>\n<h2 id=\"common-incoming-relationships\">Common Incoming Relationships</h2>\n<ul><li>`subject_of` from any endpoint whose entity is the subject of textual content.</li><li>`carries` from a Physical Object, when a physical carrier such as a manuscript or book carries the text.</li><li>`digitally_carries` from a Digital Object, when a digital carrier such as a file or web page carries the text.</li></ul>\n<h2 id=\"meta-museum-notes\">Meta Museum Notes</h2>\n<p>Meta Museum already preserves Textual Work semantics through `/api/records/{id}` fixtures for the Textual Documents profile. Existing coverage proves physical book `HumanMadeObject` carriers link to `LinguisticObject` content through `carries`, textual records preserve monograph/chapter classifications, primary and system identifiers, language, `content`, authorship `Creation`, publishing `Activity`, object `about` references, abstract-work `part_of` links, pagination statements, page-count dimensions, and `digitally_carried_by` digital carriers without collapsing copy, text, and web page into one record.</p>\n<h2 id=\"test-ideas\">Test Ideas</h2>\n<ul><li>Preserve `LinguisticObject` role coverage for textual records through `/api/records/{id}` and any dedicated textual-work endpoint.</li><li>Preserve `language`, `content`, `format`, `about`, `part_of`, `conceptually_part_of`, and `subject_to`.</li><li>Preserve authorship as `created_by` `Creation`, not as a flattened string.</li><li>Preserve publication evidence as `used_for` `Activity` with place, actor, and timespan when present.</li><li>Preserve carrier boundaries: physical objects use `carries`, digital objects use `digitally_carries`, and the text remains a distinct `LinguisticObject`.</li></ul>","updatedAt":"2026-07-06T00:00:00.000Z","checksum":"83115d01844bd7904fbd1e99be8af59f9425f27757593775928fdb5a45726f78","checksumPrefix":"83115d01844b","anchorCount":7,"lineCount":63,"rawUrl":"/api/docs/content?path=linked-art%2Fapi%2Ftextual-works.md","htmlUrl":"/docs?doc=linked-art%2Fapi%2Ftextual-works.md","apiUrl":"/api/docs/content?path=linked-art%2Fapi%2Ftextual-works.md"}