---
title: "Medias.update"
method: PATCH
path: "/entities/Medias/{id}"
tags: ["Media"]
---

# Medias.update

`PATCH /entities/Medias/{id}`

Modifies Media or Medias with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateMediaInput
  - `activity_id` string, uuid — Id of the linked appointment or task, or empty when not linked to an activity.
  - `call_id` string, uuid — Id of the linked call, or empty when not linked.
  - `data` object — Provider-specific metadata about the media (e.g. transcription identifiers, recording parameters), as a JSON object.
  - `description` string — Free-text description of the media.
  - `error_code` integer — Error code reported by the calling/recording provider when processing failed; empty on success.
  - `status` 1 | 2 | 3 | 4 | 5 | 6 — Field whose values are strictly defined with an enumeration of values. Integer enum value: 1 - NoRecording, 2 - Uploading, 3 - Uploaded, 4 - Transcoding, 5 - TranscriptionInProgress, 6 - TranscriptionCompleted
  - `type` 1 | 2 | 3 — Field whose values are strictly defined with an enumeration of values. Integer enum value: 1 - Audio, 2 - Video, 3 - Transcription
  - `revision` integer — Revision when entity was lastly changed.

## Response `200`

Modification confirmation. Returns resulting Media

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` Media
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `id` string, uuid, required — Unique identifier of entity.
    - `is_deleted` boolean — Specifies if the entity is considered deleted.
    - `modified` string, date-time — Last modification time.
    - `created` string, date-time — Creation time.
    - `appointment` string, uri — Appointment this media is attached to. Set when activity_id resolves to an Appointment. Relation to Appointment. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Appointment' object for properties.
    - `task` string, uri — Task this media is attached to. Set when activity_id resolves to a Task. Relation to Task. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Task' object for properties.
    - `call` string, uri — Call this media belongs to (e.g. a recording or transcription). Relation to Call. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Call' object for properties.
    - `activity_id` string, uuid — Id of the linked appointment or task, or empty when not linked to an activity.
    - `call_id` string, uuid — Id of the linked call, or empty when not linked.
    - `data` object — Provider-specific metadata about the media (e.g. transcription identifiers, recording parameters), as a JSON object.
    - `description` string — Free-text description of the media.
    - `error_code` integer — Error code reported by the calling/recording provider when processing failed; empty on success.
    - `status` 1 | 2 | 3 | 4 | 5 | 6 — Field whose values are strictly defined with an enumeration of values. Integer enum value: 1 - NoRecording, 2 - Uploading, 3 - Uploaded, 4 - Transcoding, 5 - TranscriptionInProgress, 6 - TranscriptionCompleted
    - `type` 1 | 2 | 3 — Field whose values are strictly defined with an enumeration of values. Integer enum value: 1 - Audio, 2 - Video, 3 - Transcription
    - `revision` integer — Revision when entity was lastly changed.
    - `audio_id` string, uuid — Id of the cloud object holding the audio recording, when available.
    - `transcription_file_id` string, uuid — Id of the cloud object holding the transcription payload, when available.
    - `transcription_id` string, required — External transcription identifier from the calling provider.
    - `transcription_language` string, required — Language requested for the transcription as a BCP-47 locale tag (e.g. "en-US", "de-DE"). Set when the transcription was requested.
    - `transcription_summary` string, required — AI-generated summary of the transcription content.
    - `get_transcription_viewer_token` string, required — Short-lived token for opening the transcription in the calling provider's viewer. Empty when no transcription is available.

## Other responses

- `404` — Sent when invalid ID is given
- `500` — unexpected error

---

[API](https://skmtc.net/aws/apis/pipeliner-cloud-api.md) · [All operations](https://skmtc.net/aws/apis/pipeliner-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pipeliner-cloud-api/revisions/e8c12ae60aca/schema)