{"id":"linked-art/api/concepts","relativePath":"linked-art/api/concepts.md","title":"Linked Art API: Concepts","markdown":"# Linked Art API: Concepts\n\n**Last refreshed:** 2026-07-06\n\nSource: [Concept endpoint](https://linked.art/api/1.0/endpoint/concept/), 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 Concept endpoint describes concepts as full dereferenceable records rather than embedded references. It covers vocabulary-like entities used throughout Linked Art records.\n\n## Required Shape\n\nA Concept 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 concept.\n- `type`: one of `Type`, `Material`, `Language`, `Currency`, or `MeasurementUnit`.\n\n## Recommended Fields\n\n- `_label`: developer-facing label.\n- `classified_as`: classifications following the `Type` structure.\n- `identified_by`: `Name` and/or `Identifier` structures.\n\n## Optional Fields\n\n- `referred_to_by`: statements about the concept.\n- `equivalent`: external identities.\n- `representation`: visual works representing the concept.\n- `member_of`: sets or concept schemes.\n- `subject_of`: textual works focused on the concept.\n- `attributed_by`: relationship assignment evidence.\n- `broader`: broader concepts.\n- `created_by`: `Creation` event for the concept.\n\n## Common Incoming Relationships\n\n- `classified_as` from almost any entity.\n- `technique` and `influenced_by` from activities.\n- `about` from textual or visual works.\n- `assigned` from `AttributeAssignment`.\n- `language` from `LinguisticObject`.\n- `currency` from `MonetaryAmount`.\n- `unit` from `Dimension`.\n- `made_of` from object material modeling.\n\n## Meta Museum Notes\n\nMeta Museum already has executable coverage for the Concept role route and record detail preservation. `/api/concepts/{id}` accepts `Type`, `Material`, `Language`, `Currency`, and `MeasurementUnit`, while record fixtures preserve `broader`, `member_of`, `equivalent`, `classified_as`, `identified_by`, and `created_by.influenced_by`.\n\n## Test Ideas\n\n- Keep `/api/concepts/{id}` role coverage aligned with the five allowed concept classes.\n- Add negative fixtures for object, actor, place, and event types when routed through `/api/concepts/{id}`.\n- Continue preserving both direct authority term IDs and local terms with authority `equivalent[]` anchors.\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-concepts\">Linked Art API: Concepts</h1>\n<p><strong>Last refreshed:</strong> 2026-07-06</p>\n<p>Source: <a href=\"https://linked.art/api/1.0/endpoint/concept/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">Concept 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 Concept endpoint describes concepts as full dereferenceable records rather than embedded references. It covers vocabulary-like entities used throughout Linked Art records.</p>\n<h2 id=\"required-shape\">Required Shape</h2>\n<p>A Concept 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 concept.</li><li>`type`: one of `Type`, `Material`, `Language`, `Currency`, or `MeasurementUnit`.</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.</li><li>`identified_by`: `Name` and/or `Identifier` structures.</li></ul>\n<h2 id=\"optional-fields\">Optional Fields</h2>\n<ul><li>`referred_to_by`: statements about the concept.</li><li>`equivalent`: external identities.</li><li>`representation`: visual works representing the concept.</li><li>`member_of`: sets or concept schemes.</li><li>`subject_of`: textual works focused on the concept.</li><li>`attributed_by`: relationship assignment evidence.</li><li>`broader`: broader concepts.</li><li>`created_by`: `Creation` event for the concept.</li></ul>\n<h2 id=\"common-incoming-relationships\">Common Incoming Relationships</h2>\n<ul><li>`classified_as` from almost any entity.</li><li>`technique` and `influenced_by` from activities.</li><li>`about` from textual or visual works.</li><li>`assigned` from `AttributeAssignment`.</li><li>`language` from `LinguisticObject`.</li><li>`currency` from `MonetaryAmount`.</li><li>`unit` from `Dimension`.</li><li>`made_of` from object material modeling.</li></ul>\n<h2 id=\"meta-museum-notes\">Meta Museum Notes</h2>\n<p>Meta Museum already has executable coverage for the Concept role route and record detail preservation. `/api/concepts/{id}` accepts `Type`, `Material`, `Language`, `Currency`, and `MeasurementUnit`, while record fixtures preserve `broader`, `member_of`, `equivalent`, `classified_as`, `identified_by`, and `created_by.influenced_by`.</p>\n<h2 id=\"test-ideas\">Test Ideas</h2>\n<ul><li>Keep `/api/concepts/{id}` role coverage aligned with the five allowed concept classes.</li><li>Add negative fixtures for object, actor, place, and event types when routed through `/api/concepts/{id}`.</li><li>Continue preserving both direct authority term IDs and local terms with authority `equivalent[]` anchors.</li></ul>","updatedAt":"2026-07-06T00:00:00.000Z","checksum":"5c3b10a975bb228149cb6c63ed690f95b64b8a77656129434578b7dc820d8dd9","checksumPrefix":"5c3b10a975bb","anchorCount":7,"lineCount":56,"rawUrl":"/api/docs/content?path=linked-art%2Fapi%2Fconcepts.md","htmlUrl":"/docs?doc=linked-art%2Fapi%2Fconcepts.md","apiUrl":"/api/docs/content?path=linked-art%2Fapi%2Fconcepts.md"}