---
title: "Update a transcript"
method: PATCH
path: "/v1/org/{orgId}/transcript/{transcriptId}"
tags: ["transcript"]
---

# Update a transcript

`PATCH /v1/org/{orgId}/transcript/{transcriptId}`

## Path parameters

- `orgId` string, required
- `transcriptId` string, required

## Request body

- UpdateTranscript
  - `calendarEntryId` string — optional calendar entry ID
  - `externalCalendarEntryId` string — optional external calendar event id from the recording system (e.g. the Google Calendar event id)
  - `externalId` string — external ID of the recording
  - `externalUrl` string — URL to view/watch the recording on the external system
  - `recordingSystem` string — system type used to record
  - `startAt` string — timestamp of the start time (inclusive)
  - `untilAt` string — timestamp of the ending time (exclusive)
  - `attendees` TranscriptAttendee[] — list of attendees
    - `id` string, required — unique speaker identifier for the transcript (equals personId if available)
    - `personId` string — ChartHop person ID, if in the system
    - `email` string — email address, if available
    - `name` string — display name, if available
    - `title` string — job title, if available
    - `orgId` string — ChartHop org ID, if available
    - `orgName` string — name of the person's organization, if available
  - `tags` string[] — tags on the transcript, such as customer name
  - `language` string — ISO 639-1 (two-letter) language code of the meeting
  - `label` string — meeting title
  - `description` string — very short description of the meeting discussion (1-3 sentences)
  - `summary` string — detailed summary of the meeting discussion (a few paragraphs)
  - `sensitive` 'GLOBAL' | 'ORG' | 'SENSITIVE' | 'PERSONAL' | 'MANAGER' | 'HIGH' | 'PRIVATE' — sensitivity level of the transcript
  - `shareAccess` ShareAccess[] — list of users and groups who have the transcript shared with them
    - `access` 'NONE' | 'LIMITED_READ' | 'LIMITED_WRITE' | 'STANDARD_READ' | 'STANDARD_WRITE' | 'COMPENSATION_READ' | 'FULL_READ' | 'COMP_PLANNING_PARTICIPANT' | 'COMPENSATION_WRITE' | 'WRITE' | 'COMPENSATION_OWNER' | 'OWNER', required — access permission level
    - `userId` string — user id
    - `groupId` string — group id
    - `fields` string — fields

## Response `204`

transcript updated

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

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