--- title: "Source Details" method: GET path: "/sources/{sourceId}" tags: ["Sources"] --- # Source Details `GET /sources/{sourceId}` Returns Source metadata. ## Response `200` - Source — Describes a Source: an abstract representation of a piece of media as defined in Sources may be elemental (and represented directly by a Flow), or may represent a collection of other Sources, e.g. a Source collecting video and audio together. - `id` string, required — A Universally Unique Identifier (UUID) as defined in [RFC9562](https://www.rfc-editor.org/rfc/rfc9562) - `format` 'urn:x-nmos:format:video' | 'urn:x-tam:format:image' | 'urn:x-nmos:format:audio' | 'urn:x-nmos:format:data' | 'urn:x-nmos:format:multi', uri, required — Identifies the content format for a Flow or Source using a URN string - `label` string — Freeform string label for the Source. This should be a very short, human-readable label that may be displayed in listings of Sources. - `description` string — Freeform text describing the Source. This should be a human-readable description that may be showed in detailed views of Sources. The description should be longer and more detailed than `label`. - `created_by` string — A string identifier for the entity that created the Source. Service implementations SHOULD set suitable default values for `created_by` based on the principal accessing the systems. - `updated_by` string — A string identifier for the entity that updated the Source metadata most recently. Service implementations SHOULD set suitable default values for `updated_by` based on the principal accessing the system. - `created` string, date-time — The date-time the Source was created in a given context, e.g. in the service instance. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally - `updated` string, date-time — The date-time the Source metadata was last updated in a given context, e.g. in the service instance. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally - `tags` Tags — Key is a freeform string. Value is a freeform string, or an array of freeform strings. - `source_collection` Collectionitem[] — List of Sources that are collected together by this Source. This attribute is intended to be read-only. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally. Source collections can be inferred from Flow collection definitions. - `id` string, required — A Universally Unique Identifier (UUID) as defined in [RFC9562](https://www.rfc-editor.org/rfc/rfc9562) - `role` string, required — A human-readable role of the element in this collection (e.g. 'R' to denote a right audio channel in a collection of mono audio Sources) - `collected_by` Uuid[] — Sources that reference this Source to include it in a collection. This attribute is intended to be read-only. Service implementations SHOULD ignore this if given in a PUT request, and instead manage it internally. Source collections can be inferred from Flow collection definitions. ## Other responses - `404` — The requested Source does not exist. ## Changes - **2025-10-15** `552be51d35bd` — 1 breaking - removed 'propertyNames' constraint from the `tags` response property for the status `200` - **2025-10-15** `8639ecff0b6c` — 1 breaking, 1 info - response property `tags/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `200` - added 'propertyNames' constraint to the `tags` response property for the status `200` - **2025-07-02** `fff531b4534a` — 1 warning - removed the optional property `source_collection/items/container_mapping` from the response with the `200` status - **2025-06-11** `e3d4dd57646b` — 1 warning - added the new `urn:x-tam:format:image` enum value to the `format` response property for the response status `200` - **2025-04-24** `b01aaf8cffe2` — 3 info - added the optional property `source_collection/items/container_mapping` to the response with the `200` status - removed the `urn:x-tam:format:image` enum value from the `format` response property for the response status `200` - response property `tags/additionalProperties/` list-of-types was narrowed by removing types `array` from media type `application/json` of response `200` [Change history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/sources/:sourceId/get.md) --- [API](https://skmtc.dev/aws-samples/apis/time-addressable-media-store.md) · [All operations](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/time-addressable-media-store/revisions/4c8d2bfcb854/schema)