Skip to main content

Overview

The deleteTranscript mutation is designed to delete a specific transcript by its ID.
Permissions: Users can delete meetings they own. Deleting another team member’s meeting requires team admin privileges. For a meeting with more than one owner, the mutation decides what happens. It deletes the meeting for everyone when the caller is the meeting’s host or organizer, a team admin acting for the host, or the last remaining owner. Any other co-owner’s call removes the meeting only from their own account, and the other owners keep it. Deleting a co-owned meeting for everyone also requires team delete permission, unless the caller owns the meeting or is its last remaining owner. The response is the same Transcript in both cases, so it does not tell you whether the meeting was deleted for everyone. The MEETING_DELETED audit event records which one in its deleteMode metadata: deleted or removed.
Rate Limit: This mutation is rate-limited to 10 requests per minute across all user tiers. If you exceed this limit, you will receive a too_many_requests error with a retryAfter timestamp indicating when you can make requests again.

Arguments

String
required
Transcript ID

Usage Example

To delete a transcript, provide the unique id of the transcript as an argument to the mutation. The returned subfields will be from the deleted transcript. Here’s an example of how this mutation could be used:

Error Codes

List of possible error codes that may be returned by the deleteTranscript mutation. Full list of error codes can be found here.

This error is returned when a user attempts to delete another team member’s meeting without team admin privileges, or attempts to delete or remove their access from a shared meeting without the required permissions. Users can delete their own meetings without admin privileges.

You have exceeded the rate limit of 10 requests per minute. Wait until the time specified in the retryAfter field before making additional requests.

Additional Resources

Transcripts

Querying list of transcripts

Update Meeting Privacy

Update meeting privacy