---
title: "Hides or shows a Media"
method: POST
path: "/admin/medias/{media_id}/hide"
tags: ["Audio"]
---

# Hides or shows a Media

`POST /admin/medias/{media_id}/hide`

## Path parameters

- `media_id` integer, required

## Request body

- MediaHideRequest
  - `is_hidden` boolean, required
  - `admin_action` AdminActionRequest
    - `reason_id` integer, required
    - `ticket_reference` string, required
    - `comments` string, required

## Response `200`

OK

- MediaHideResponse
  - `id` integer — The media id
  - `is_hidden` boolean — The media hidden state
  - `is_deleted` boolean — The media deleted state
  - `admin_action` AdminActionResponse
    - `id` integer — The admin action id
    - `reason_id` integer — The admin action reason id
    - `hidden_by_id` integer — The user that made the entity hidden
    - `hidden_at` string, date-time — The date and time that made the entity hidden
    - `is_marked_for_manual_deletion` boolean — The entity was manually marked for deletion
    - `marked_for_manual_deletion_by_id` integer — The user that marked the entity for deletion
    - `marked_for_manual_deletion_at` string, date-time — The date and time that the entity was marked for deletion
    - `ticket_reference` string — The ticket reference for the admin action
    - `comments` string — The comments for the admin action

## Other responses

- `401` — Unauthorised Error
- `403` — Forbidden Error
- `404` — Not Found Error
- `409` — Data conflicting

---

[API](https://skmtc.net/hm-courts-and-tribunals-service/apis/modernised-darts.md) · [All operations](https://skmtc.net/hm-courts-and-tribunals-service/apis/modernised-darts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hm-courts-and-tribunals-service/modernised-darts/revisions/dba37a557db4/schema)