Overview
ThedeleteTranscript 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
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 thedeleteTranscript mutation. Full list of error codes can be found here.
require_elevated_privilege
require_elevated_privilege
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.
too_many_requests
too_many_requests
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