# 3Play Media Documentation

> Explore 3Play Media's comprehensive API documentation, designed to guide developers through the integration process. Access powerful features for video transcription, translation, and captioning services. Boost accessibility and enhance your user experience with our detailed guides and code examples.

## Guides
- [Introduction](https://docs.3playmedia.dev/docs/introduction.md)
- [Authentication](https://docs.3playmedia.dev/docs/authentication.md)
- [Using Callback URLs](https://docs.3playmedia.dev/docs/using-callback-urls.md)
- [Order Human Captions](https://docs.3playmedia.dev/docs/ordering-captions-transcription.md)
- [Order Dubs](https://docs.3playmedia.dev/docs/order-dubbing.md)
- [Order Subs (machine translation)](https://docs.3playmedia.dev/docs/order-subs-machine-translation.md)
- [Order Human Translation](https://docs.3playmedia.dev/docs/ordering-translation.md)
- [Transcription-Only Accounts](https://docs.3playmedia.dev/docs/transcription-only-accounts.md)
- [Observer Keys](https://docs.3playmedia.dev/docs/observer-keys.md): Read-only access to specific collections

## API Reference
- [List API Accesses](https://docs.3playmedia.dev/reference/listapiaccesses-1.md): List API accesses within an account
- [Create API Access](https://docs.3playmedia.dev/reference/createapiaccess-1.md): Create new API access for a project
- [Disable Project API Access](https://docs.3playmedia.dev/reference/disableprojectapiaccess-1.md): Disable all API accesses for a project
- [View API Access](https://docs.3playmedia.dev/reference/showapiaccess-1.md): View details for a single API access
- [Disable API Access](https://docs.3playmedia.dev/reference/disableapiaccess-1.md): Disable an API access
- [Enable API Access](https://docs.3playmedia.dev/reference/enableapiaccess-1.md): Enable an API access
- [List Invoice Line Items](https://docs.3playmedia.dev/reference/invoicelineitems-1.md): View line items for specific charges attached to invoices on an account
- [List Invoices](https://docs.3playmedia.dev/reference/listinvoices-1.md): List invoices on an account
- [Show Current Invoice](https://docs.3playmedia.dev/reference/showcurrentinvoice-1.md): Show details for the current invoice
- [Show Invoice](https://docs.3playmedia.dev/reference/showinvoice-1.md): Show details for an invoice
- [List Projects](https://docs.3playmedia.dev/reference/listprojects-1.md): List projects within an account. Requires an admin API key.
- [Create Project](https://docs.3playmedia.dev/reference/createproject-1.md): Create a new project. Requires an admin API key.
- [View Project (Admin)](https://docs.3playmedia.dev/reference/adminviewproject-1.md): View project details
- [Update Project](https://docs.3playmedia.dev/reference/adminupdateproject-1.md): Update project details
- [List User Accesses](https://docs.3playmedia.dev/reference/listuseraccesses-1.md): List user accesses
- [Create User Access](https://docs.3playmedia.dev/reference/createuseraccesses-1.md): Grant access permissions to a user
- [Update User Access](https://docs.3playmedia.dev/reference/updateuseraccess-1.md): Update access permissions for a user
- [Revoke User Access](https://docs.3playmedia.dev/reference/revokeuseraccess-1.md): Revoke all access permissions for a user
- [List Users](https://docs.3playmedia.dev/reference/listusers-1.md): List users within an account. Requires an admin API key.
- [Create User](https://docs.3playmedia.dev/reference/createuser-1.md): Create a new user. Requires an admin API key.
- [View User](https://docs.3playmedia.dev/reference/viewuser-1.md): View user details
- [Update User](https://docs.3playmedia.dev/reference/updateuser-1.md): Update user details
- [List Audio Descriptions](https://docs.3playmedia.dev/reference/listaudiodescriptions-1.md): List audio descriptions
- [List Audio Description Audio Formats](https://docs.3playmedia.dev/reference/listaudiodescriptionaudioformats-1.md): List audio description audio formats
- [List Audio Description Mix Formats](https://docs.3playmedia.dev/reference/listaudiodescriptionmixformats-1.md): List audio description mix formats
- [Order Audio Description](https://docs.3playmedia.dev/reference/orderaudiodescriptions-1.md): Order a new audio description for the provided media file
- [List Audio Description Text Download Formats](https://docs.3playmedia.dev/reference/listaudiodescriptiontextdownloadformats-1.md): List audio description text download formats
- [List Audio Description Text Formats](https://docs.3playmedia.dev/reference/listaudiodescriptiontextformats-1.md): List audio description text formats
- [Get Audio Description by ID](https://docs.3playmedia.dev/reference/getaudiodescriptionsbyid-1.md): Retrieve a specific audio description
- [Download Audio Description Media Audio](https://docs.3playmedia.dev/reference/downloadaudiodescriptionmediaaudio-1.md): Download audio description media without source audio or video. Returns a payload with an expiring S3 URL. Make a GET request to this URL to retrieve the audio description audio.
- [Send Immediate Callback (Audio Description)](https://docs.3playmedia.dev/reference/sendimmediatecallbackaudiodescription-1.md): Send callback immediately to all registered callback URLs associated with the audio description
- [Cancel Audio Description](https://docs.3playmedia.dev/reference/cancelaudiodescription-1.md): Cancel the specified audio description
- [Expiring Editing Link (Audio Description)](https://docs.3playmedia.dev/reference/expiringeditinglink-1.md): Receive an expiring editing link for the audio description
- [Download Audio Description Media](https://docs.3playmedia.dev/reference/downloadaudiodescriptionmedia-1.md): Download audio description media such as description text and mixed source. Returns a payload with an expiring S3 URL. Make a GET request to this URL to retrieve the audio description mix.
- [Redeliver Audio Description](https://docs.3playmedia.dev/reference/redeliveraudiodescription-1.md): Redeliver an audio description to its pre-assigned endpoint (e.g. 3rd party integrations, FTP locations)
- [Get Audio Description Text](https://docs.3playmedia.dev/reference/downloadaudiodescriptionmediatext-1.md): View audio description text
- [Download Audio Description Text](https://docs.3playmedia.dev/reference/downloadaudiodescriptionmediatextdownload-1.md): Download audio description text directly.
- [Upgrade Audio Description Turnaround Level](https://docs.3playmedia.dev/reference/upgradeaudiodescriptionturnaroundlevel-1.md): Upgrade audio description turnaround level
- [Create Audio Description](https://docs.3playmedia.dev/reference/createdescriptions.md): Create audio descriptions for media. This is a streamlined version of the /v3/audio_descriptions/order endpoint that allows you to upload media and order AD in a single API call. Using this endpoint to create a file and order Audio Description simultaneously will create an ASR service order and incur additional costs.
- [View Audio Description](https://docs.3playmedia.dev/reference/viewdescription.md): View audio description details. This is a streamlined version of the /v3/audio_descriptions/{id} which allows you to get download information in a single API call.
- [List Audio Description Delivery Routes](https://docs.3playmedia.dev/reference/listaudiodescriptiondeliveryroutes-1.md): List available audio description delivery routes in the project
- [Create Audio Description Delivery Route](https://docs.3playmedia.dev/reference/createaudiodescriptiondeliveryroute-1.md): Create a new project-wide audio description delivery route
- [Edit Audio Description Delivery Route](https://docs.3playmedia.dev/reference/editaudiodescriptiondeliveryroute-1.md): Edit existing audio description delivery route
- [Delete Audio Description Delivery Route](https://docs.3playmedia.dev/reference/deleteaudiodescriptiondeliveryroute-1.md): Delete an existing audio description delivery route
- [List Delivery Routes](https://docs.3playmedia.dev/reference/listdeliveryroutes-1.md): List available delivery routes in the project
- [Create Delivery Route](https://docs.3playmedia.dev/reference/createdeliveryroute-1.md): Creates a new project-wide delivery route.
- [Edit Delivery Route](https://docs.3playmedia.dev/reference/editdeliveryroute-1.md): Edit existing delivery route
- [Delete Delivery Route](https://docs.3playmedia.dev/reference/deletedeliveryroute-1.md): Delete an existing delivery route
- [List Batches](https://docs.3playmedia.dev/reference/listbatches-1.md): List batches in the project
- [Create New Batch](https://docs.3playmedia.dev/reference/createnewbatch-1.md): Create a new batch in the project
- [Get Batch by ID](https://docs.3playmedia.dev/reference/getbatchbyid-1.md): Retreive a batch's details
- [Archive Batch](https://docs.3playmedia.dev/reference/archivebatch-1.md): Archive the existing batch
- [Configure Batch](https://docs.3playmedia.dev/reference/configurebatch-1.md): Configure settings for the batch with the provided ID
- [Unarchive Batch](https://docs.3playmedia.dev/reference/unarchivebatch-1.md): Unarchive an archived batch
- [List Cheat Sheets (Order Instructions)](https://docs.3playmedia.dev/reference/listcheatsheets-1.md): List cheat sheets in the project. Also known as order instructions.
- [Create Cheat Sheet](https://docs.3playmedia.dev/reference/createcheatsheet-1.md): Create a new cheat sheet
- [Get Cheat Sheet by ID](https://docs.3playmedia.dev/reference/getcheatsheetbyid-1.md): Get cheat sheet by ID
- [Update Cheat Sheet](https://docs.3playmedia.dev/reference/updatecheatsheet-1.md): Update an existing cheat sheet
- [List Dubs](https://docs.3playmedia.dev/reference/listdubs-1.md): List dubs filtered by folder name
- [Create Dubs](https://docs.3playmedia.dev/reference/createdubs-1.md): Create dubs for media in multiple target languages. If you post to `/dubs` multiple times with different sets of source and target languages for the same "external_media_id," we'll ignore any pairs we've already processed and only add new pairs. You will not get callback_url calls for those that are duplicates.
- [View Dub](https://docs.3playmedia.dev/reference/viewdub-1.md): View dub details including download links
- [List Media Files](https://docs.3playmedia.dev/reference/listmediafiles-1.md): List media files in the project
- [Create Media File](https://docs.3playmedia.dev/reference/createmediafile-1.md): Create a new media file. Requires either a source URL or video file.
- [Archive File(s)](https://docs.3playmedia.dev/reference/archivefiles-1.md): Archive one or more media files. Archived media files are hidden from the account view.
- [Unarchive File(s)](https://docs.3playmedia.dev/reference/unarchivefiles-1.md): Unarchive one or more media files
- [Get Media File by ID](https://docs.3playmedia.dev/reference/getmediafilebyid-1.md): Details of the media file
- [Update Media File](https://docs.3playmedia.dev/reference/updatemediafile-1.md): Update the media file's metadata
- [Set File Configurations](https://docs.3playmedia.dev/reference/setfilesetting-1.md): Set the media file's configurations
- [Set File Language](https://docs.3playmedia.dev/reference/setfilelanguage-1.md): Set the media file's language prior to ordering transcription or audio description
- [Upload File to Media File](https://docs.3playmedia.dev/reference/uploadsourcefiletomediafile-1.md): Upload a source file to the media file
- [Remove Source from Media File](https://docs.3playmedia.dev/reference/removesourcefrommediafile-1.md): Remove a source file or source URL from the media file. Returns the media file.
- [Add Source URL to Media File](https://docs.3playmedia.dev/reference/addsourceurlto3playmediafile-1.md): Add a source URL to the media file
- [List Glossaries](https://docs.3playmedia.dev/reference/listglossaries-1.md): List glossaries in the project
- [Create Glossary](https://docs.3playmedia.dev/reference/createglossary-1.md): Create a new glossary for a media file, project, or batch
- [Update Glossary](https://docs.3playmedia.dev/reference/updateglossary-1.md): Update an existing glossary
- [Get Glossary by ID](https://docs.3playmedia.dev/reference/getglossarybyid-1.md): Get glossary by ID
- [List All Languages](https://docs.3playmedia.dev/reference/listalllanguages-1.md): List all languages
- [List Translation Service Options](https://docs.3playmedia.dev/reference/listtranslationserviceoptions-1.md): List translation service options. Use /languages to determine the applicable languages.
- [List Turnaround Levels](https://docs.3playmedia.dev/reference/listturnaroundlevels-1.md): List turnaround levels for transcription
- [List Video Platform Integrations (VPIs)](https://docs.3playmedia.dev/reference/listvideoplatformintegrations-1.md): List video platform integrations (VPIs). Also known as Linked Accounts.
- [List Live Auto Captioning](https://docs.3playmedia.dev/reference/listautolivecaptioning-1.md): List live auto captioning event details in the project
- [Order Live Auto Captions](https://docs.3playmedia.dev/reference/orderliveautocaptions-1.md): Order a new live auto captioning event for a specified Media File.
- [Get Ordering Help (Live Auto Captions)](https://docs.3playmedia.dev/reference/getorderinghelpliveauto-1.md): Additional details about ordering
- [Get Live Auto Captioning by ID](https://docs.3playmedia.dev/reference/getautolivecaptioningbyid-1.md): List live auto captioning event details based on the provided ID
- [Update Live Auto Captions](https://docs.3playmedia.dev/reference/updateliveautocaptions-1.md): Update a live auto captioning event
- [Archive Live Auto Caption](https://docs.3playmedia.dev/reference/archiveliveautocaptions-1.md): Archive a live auto captioning event. This is only available if the event has finished or was cancelled.
- [Cancel Live Auto Caption](https://docs.3playmedia.dev/reference/cancelliveautocaptions-1.md): Cancel a live auto captioning event
- [Finish Live Auto Caption](https://docs.3playmedia.dev/reference/finishliveautocaptions-1.md): Finish a live auto captioning event (e.g. if the stream has not ended but the event has)
- [Unarchive Live Auto Caption](https://docs.3playmedia.dev/reference/unarchiveliveautocaptions-1.md): Unarchive a live auto captioning event
- [Get Live Wordlist (Live Auto Captions)](https://docs.3playmedia.dev/reference/getlivewordlistliveauto-1.md): Show a specific live wordlist based on the provided ID
- [List Live Professional Captions](https://docs.3playmedia.dev/reference/listliveprofessionalcaptions-1.md): List live professional captioning details in the project
- [Order Live Professional Captioning](https://docs.3playmedia.dev/reference/orderliveprofessionalcaptions-1.md): Order new live professional captioning
- [Get Ordering Help (Live Professional Captions)](https://docs.3playmedia.dev/reference/getorderinghelpliveprofessional-1.md): Additional details about ordering
- [Get Live Professional Captions by ID](https://docs.3playmedia.dev/reference/getliveprofessionalcaptioningbyid-1.md): Retrieve live professional caption details
- [Update Live Professional Captioning](https://docs.3playmedia.dev/reference/updateliveprofessionalcaptioning-1.md): Update existing live professional captioning
- [Archive Live Professional Caption](https://docs.3playmedia.dev/reference/archiveliveprofessionalcaption-1.md): Archive live professional captioning if already finished or cancelled
- [Cancel Live Professional Captioning](https://docs.3playmedia.dev/reference/cancelliveprofessionalcaptions-1.md): Cancel the live professional captioning event
- [Finish Live Professional Captioning](https://docs.3playmedia.dev/reference/finishliveprofessionalcaptions-1.md): Finish live professional captioning (e.g. if the stream has not ended but the event has)
- [Unarchive Live Professional Caption](https://docs.3playmedia.dev/reference/unarchiveliveprofessionalcaptions-1.md): Unarchive live professional captioning if already archived
- [Get Live Wordlist (Live Professional Captions)](https://docs.3playmedia.dev/reference/getlivewordlistliveprofessional-1.md): Retrieve the wordlist of the life professional captions
- [List Live Transcoders](https://docs.3playmedia.dev/reference/listlivetranscoders-1.md): List transcoders in the project
- [Bulk Order Transcription](https://docs.3playmedia.dev/reference/bulkorder-1.md): Bulk order transcription services
- [View Project](https://docs.3playmedia.dev/reference/viewproject-1.md): View project details
- [View Project Configuration](https://docs.3playmedia.dev/reference/viewprojectconfiguration-1.md): View project configuration details
- [Update Project Configuration](https://docs.3playmedia.dev/reference/updateprojectconfiguration-1.md): Update project configuration details
- [Approve Service](https://docs.3playmedia.dev/reference/approveservice-1.md): Approve a service
- [List Pending Approvals](https://docs.3playmedia.dev/reference/listserviceapprovals-1.md): List all services pending approval
- [Show Pending Approval](https://docs.3playmedia.dev/reference/showserviceapproval-1.md): Show pending approval for a service
- [List Subs](https://docs.3playmedia.dev/reference/listsubs-1.md): List subs filtered by folder name
- [Create Subs](https://docs.3playmedia.dev/reference/createsubs-1.md): Create subs for media in multiple target languages. If you post to `/subs` multiple times with different sets of source and target languages for the same "external_media_id," we'll ignore any pairs we've already processed and only add new pairs. You will not get callback_url calls for those that are duplicates.
- [View Sub](https://docs.3playmedia.dev/reference/viewsub-1.md): View sub details including download links
- [List Transcripts](https://docs.3playmedia.dev/reference/listtranscripts-1.md): List all available transcripts in the project
- [Order Alignment Service](https://docs.3playmedia.dev/reference/orderalignmentservice-1.md): Order an alignment service on the provided media file. The media file must have a valid source file or source url.
- [Order Alignment Service Help](https://docs.3playmedia.dev/reference/orderalignmentservicehelp.md): Additional information about ordering alignment
- [Order ASR Service](https://docs.3playmedia.dev/reference/orderasrservice-1.md): Order Automated Speech Recognition (ASR) service on the provided media file. The media file must have a valid source file or source url.
- [Order ASR Service Help](https://docs.3playmedia.dev/reference/orderasrservicehelp.md): Additional information about ordering Automated Speech Recognition (ASR)
- [Order Caption Import](https://docs.3playmedia.dev/reference/ordercaptionimportservice-1.md): Order caption import
- [Order Caption Import Service Help](https://docs.3playmedia.dev/reference/ordercaptionimportservicehelp-1.md): Additional information about ordering caption import
- [Order Transcript Service](https://docs.3playmedia.dev/reference/ordertranscriptservice-1.md): Order a new transcription service on the provided media file. The media file must have a valid source file or source url.
- [Order Transcript Service Help](https://docs.3playmedia.dev/reference/ordertranscriptservicehelp.md): Additional information about ordering transcription
- [List Available Turnarounds](https://docs.3playmedia.dev/reference/listtranscriptionturnarounds-1.md): List available transcription turnarounds for a media file
- [Order Translation Service](https://docs.3playmedia.dev/reference/ordertranslationservice-1.md): Order a translation service on the provided media file. Use /translation_service_options to determine the applicable option.
- [Order Translation Service Help](https://docs.3playmedia.dev/reference/ordertranslationservicehelp.md): Additional information about ordering translation
- [Order Video Clip Captioning Service](https://docs.3playmedia.dev/reference/orderviccservice-1.md): Order a video clip captioning service on the provided media file. The media file must have a parent media file assigned (see files update and create).
- [Order Video Clip Captioning Service Help](https://docs.3playmedia.dev/reference/ordervideoclipcaptioningservicehelp-1.md): Additional information about ordering video clip captioning
- [Get Available Output Formats](https://docs.3playmedia.dev/reference/getavailableoutputformats-1.md): Supported output formats, including type, extension, and description
- [Get Transcript by ID](https://docs.3playmedia.dev/reference/getranscriptbyid-1.md): Retrieve transcript details by ID
- [Send Immediate Callback (Transcript)](https://docs.3playmedia.dev/reference/sendimmediatecallback-1.md): Send an immediate callback to any callback URLs registered on the transcript's media file
- [Cancel Transcript](https://docs.3playmedia.dev/reference/canceltranscript-1.md): Cancel the ordered transcript
- [Download Transcript](https://docs.3playmedia.dev/reference/downloadtranscript-1.md): Download the transcript
- [Expiring Editing Link (Transcript)](https://docs.3playmedia.dev/reference/expiringtranscriptexpiringeditinglink-1.md): Receive an expiring editing link for the transcript
- [Make Transcript Default](https://docs.3playmedia.dev/reference/maketranscriptdefault-1.md): Make a transcript the default for its media file. Only one transcript can be default on a given file.
- [Redeliver Transcript](https://docs.3playmedia.dev/reference/redelivertranscript-1.md): Redeliever a transcript via any existing delivery methods
- [Retry Rejected Transcript](https://docs.3playmedia.dev/reference/retrytranscript-1.md): Retry a rejected transcript. A transcript can be retried only once, and only if it was rejected by 3play. Cancelled transcripts cannot be retried.
- [Get Formatted Text for Transcript](https://docs.3playmedia.dev/reference/getformattedtextfortranscript-1.md): Retrieve formatted text for a transcript, wrapped in default JSON structure
- [Update Transcript Turnaround Level](https://docs.3playmedia.dev/reference/updatetranscriptturnaroundlevel-1.md): Upgrade the turnaround level of a transcript. Turnaround levels can only be upgraded for English files and cannot be changed once an editor has begun transcribing.
- [List Translation Profiles](https://docs.3playmedia.dev/reference/listtranslationprofiles-1.md): List translation profiles in the project. (Deprecated: Reading translation profiles through the API may not be supported in the future.)
- [Create Translation Profile](https://docs.3playmedia.dev/reference/createtranslationprofile-1.md): Deprecated: Creating translation profiles through the API is not supported
- [Edit Translation Profile](https://docs.3playmedia.dev/reference/edittranslationprofile-1.md): Deprecated: Updating translation profiles through the API is not supported
- [List Translation Profile Options](https://docs.3playmedia.dev/reference/listtranslationprofilesoptions-1.md): Deprecated: Listing translation vendor options through the API is not supported.
- [Authenticate](https://docs.3playmedia.dev/reference/authenticate-1.md): Ensure the API key is valid