Skip to main content
PATCH
Rename Batch Jobs

Overview

Rename episode filenames in a paused batch. The batch must be in paused status (created with paused: true).

Header Parameters

string
required
Your API key for authentication

Path Parameters

string
required
The batch UUID returned from POST /jobs

Request Body

array
required
List of rename operations
Each rename item contains:
string
required
The job UUID to rename (must belong to this batch)
string
required
New filename (without extension). Sanitization transliterates to ASCII alphanumerics, replaces punctuation/whitespace with underscores and rejects an empty result.

Response

integer
Number of jobs successfully renamed
array
List of error messages for failed renames

Example

Renames are processed individually, so a 200 can contain errors and partial updates. Marketplace batch access is refused with 403; storage/queue failures can return 500.

Error Responses