---
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 <https://specs.amwa.tv/ms-04/releases/v1.0.0/docs/2.2._Explanation_-_Source.html> 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 — The purpose of this element in the collection, primarily intended to be human-readable.
  - `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

> 23 revisions in range; 16 could not be searched.

- **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/eb3977b33601/schema)