---
title: "Set Transcript Status"
method: PUT
path: "/api/v1/admin/transcripts/{transcript_id}/status"
tags: ["Admin APIs", "transcripts"]
---

# Set Transcript Status

`PUT /api/v1/admin/transcripts/{transcript_id}/status`

Set the visibility status of a single transcript.

## Path parameters

- `transcript_id` string, uuid, required

## Request body

- TranscriptStatusUpdate
  - `status` 'published' | 'hidden' | 'removed', required
  - `reason` string, nullable

## Response `200`

Successful Response

- TranscriptRead
  - `id` string, uuid, required
  - `external_id` string, required
  - `catalog_source_id` string, uuid, required
  - `title` string, required
  - `status` string, required
  - `language` string, required
  - `transcript_type` string, required
  - `interview_date` string, date, required
  - `duration_minutes` integer, required
  - `expert_anonymized` boolean, required
  - `meta_data` object, required
  - `expert_id` string, nullable
  - `description` string, nullable
  - `entities` TranscriptEntityRef[]
    - `id` string, required
    - `label` string, required
  - `region` string, nullable
  - `published_at` string, date-time, nullable
  - `status_reason` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `has_pdf` boolean

## Other responses

- `422` — Validation Error

## Changes

> 4 revisions in range; 1 could not be searched.

- **2026-08-21** `a8ca30023371` — 4 info
  - added the optional property `description` to the response with the `200` status
  - added the optional property `entities` to the response with the `200` status
  - added the optional property `expert_id` to the response with the `200` status
  - added the optional property `region` to the response with the `200` status

[Change history](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api/changes/api/v1/admin/transcripts/:transcript_id/status/put.md)

---

[API](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/56e2edae9dfe/schema)