---
title: "Update transcript status (admin)"
method: PATCH
path: "/v2/transcripts/internal/{transcript_id}/status"
tags: ["Transcripts Internal"]
---

# Update transcript status (admin)

`PATCH /v2/transcripts/internal/{transcript_id}/status`

Set status to published, hidden, or removed. Draft is not settable via this endpoint.

## Path parameters

- `transcript_id` string, required

## Request body

- TranscriptStatusUpdate — Admin status update — only published/hidden/removed allowed (never draft). Constraints are enforced explicitly in the route handler via HTTPException so they fire in both local and CI test environments (Pydantic's automatic RequestValidationError is not reliably serialisable in all test setups).
  - `status` string, required
  - `reason` string, nullable

## Response `200`

Successful Response

- TranscriptResponse — Built from a Transcript ORM instance via model_validate.
  - `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
  - `raw_text_s3_uri` string, required
  - `pdf_s3_uri` string, nullable
  - `meta_data` object, required
  - `entities` TranscriptEntity[]
    - `id` string, required
    - `label` string, required
  - `region` string, nullable
  - `description` string, nullable
  - `published_at` string, date-time, nullable
  - `status_reason` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/versions/bd33ea42994c/schema)