← Documentation home

Canonical Markdown source · Jul 6, 2026

Linked Art API: Concepts

linked-art/api/concepts.md · 56 lines · SHA-256 5c3b10a975bb

Last refreshed: 2026-07-06

Source: Concept endpoint, part of Linked Art API 1.0, published under CC BY 4.0. This is a project summary; the upstream page is authoritative.

Purpose

The Concept endpoint describes concepts as full dereferenceable records rather than embedded references. It covers vocabulary-like entities used throughout Linked Art records.

Required Shape

A Concept record dereferences to one JSON-LD object:

  • `@context`: Linked Art context URI, or an array ending with that URI for extensions.
  • `id`: dereferenceable HTTP(S) URI for the concept.
  • `type`: one of `Type`, `Material`, `Language`, `Currency`, or `MeasurementUnit`.
  • `_label`: developer-facing label.
  • `classified_as`: classifications following the `Type` structure.
  • `identified_by`: `Name` and/or `Identifier` structures.

Optional Fields

  • `referred_to_by`: statements about the concept.
  • `equivalent`: external identities.
  • `representation`: visual works representing the concept.
  • `member_of`: sets or concept schemes.
  • `subject_of`: textual works focused on the concept.
  • `attributed_by`: relationship assignment evidence.
  • `broader`: broader concepts.
  • `created_by`: `Creation` event for the concept.

Common Incoming Relationships

  • `classified_as` from almost any entity.
  • `technique` and `influenced_by` from activities.
  • `about` from textual or visual works.
  • `assigned` from `AttributeAssignment`.
  • `language` from `LinguisticObject`.
  • `currency` from `MonetaryAmount`.
  • `unit` from `Dimension`.
  • `made_of` from object material modeling.

Meta Museum Notes

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`.

Test Ideas

  • Keep `/api/concepts/{id}` role coverage aligned with the five allowed concept classes.
  • Add negative fixtures for object, actor, place, and event types when routed through `/api/concepts/{id}`.
  • Continue preserving both direct authority term IDs and local terms with authority `equivalent[]` anchors.