# Episodes

Read, edit and rule on the episodes of a dataset.

- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_listepisodes.md): Lists the episodes of a dataset in recording order (for a mixture: its pool, source by source).
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_getepisode.md): Gets one episode as its parent dataset sees it.
- [`PATCH /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_updateepisode.md): Deprecated: use UpdateEpisodes with one edit, which this now runs.
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}/draft`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_getepisodedraft.md): The take's draft, through any dataset that reads the take.
- [`DELETE /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}/draft`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_deleteepisodedraft.md): Discards the take's draft.
- [`PATCH /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}/draft`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_updateepisodedraft.md): Saves the take's draft as drawn: replaces the drawing and its base, or creates the draft (allow_missing).
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}/revisions`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_listepisoderevisions.md): An episode's edits, newest first, then the recording as revision 0; an episode nobody edited lists nothing.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:acquireEpisodeLease`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_acquireepisodelease.md): Takes the take's edit lease for the caller and this tab.
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:locate`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_locateepisode.md): Where one episode sits in a filtered, ordered list of its dataset: its position and neighbours, for "12 / 340" and prev / next in the studio.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:markViewed`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_markepisodeviewed.md): Records that the caller opened an episode.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:releaseEpisodeLease`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_releaseepisodelease.md): Takes this tab off the caller's lease, and ends the lease when it was the last tab.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:renewEpisodeLease`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_renewepisodelease.md): Renews the caller's lease for 30 s more.
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:sampleSeries`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_sampleepisodeseries.md): The episode's joint series: each state and action channel sampled evenly over the take's current content: the joints drawer's charts, and the arm's motion the camera lag drawer sets each camera's o...
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:signVideos`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_signepisodevideos.md): Signs the episode's camera videos for playback: one short-lived URI per camera, of the take's current content (the member of its upload's published version), and where that content sits in the epis...
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:takeOverEpisodeLease`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_takeoverepisodelease.md): Replaces another person's live lease with the caller's, for this tab, and records EPISODE_LEASE_TAKEN (not undoable).
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:unsplit`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_unsplitepisode.md): Discards the split drawn on an episode's draft, with the draft.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:assignTask`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_assigntask.md): Sets one task label on every selected episode of an upload in a single publication: all of them or none.
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes:batchSampleSeries`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_batchsampleepisodeseries.md): Several episodes' series at once, each as SampleEpisodeSeries samples it: what a dataset's trajectories read.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:keep`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_keepepisodes.md): Keeps episodes in the parent's scope, closing their open issues in that scope only.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:linkTaskLabels`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_linktasklabels.md): Links the unlinked episodes, uploads and merged datasets of the caller's workspace whose free-text task label is a task's name (a merged dataset by its own labels.task, and never an upload a merge ...
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:reject`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_rejectepisodes.md): Rejects episodes in the parent's scope.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:reset`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_resetepisodes.md): Withdraws the standing ruling made in the parent's scope, so the episode falls back to what stood before.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:restore`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_restoreepisodes.md): Puts back episodes ingest validation rejected, with a required reason.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:reviewSuggestions`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_reviewsuggestions.md): Settles every PROPOSED subtask span of one origin over the episodes a filter leaves: accept or reject in one call.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:split`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_splitepisodes.md): Splits episodes at given cuts, around kept windows or at their markers: each split is drawn on the episode's draft (EpisodeDraft), its pieces the windows kept, each tagged with the labels of the ma...
- [`GET /v1/accounts/{account}/datasets/{dataset}/episodes:summarize`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_summarizeepisodes.md): Counts, facets and metric distributions over the episodes a filter leaves: what the filter chips, the status bar and the outlier cards read.
- [`POST /v1/accounts/{account}/datasets/{dataset}/episodes:update`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/episodes_updateepisodes.md): Edits episodes of a dataset in one call: task, instruction, method, methods, scene, tags, outcome, trim, subtasks or linked_task, each edit with its own field mask and etag.