Skip to main content
GET
List jobs
Work started in the web app or API v2 has no job: read processing_state or the lip-sync and on-screen state. When to use: to find a project’s active jobs or audit recent work. Side effects: None. Cost: Free. Idempotency: safe and pure (never writes); retry freely. Pagination: limit (default 20, max 100) and cursor; follow next_cursor until has_more is false. Required scopes: jobs:read

Authorizations

Authorization
string
header
required

API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).

Scopes

jobs:read

Query Parameters

project_id
string

Only this project.

Maximum string length: 64
media_id
string

Only this media.

Maximum string length: 64
type
enum<string>[]

Comma-separated job types.

Maximum array length: 10

Job type. Open enum: new types are added over time.

  • media_import: registering uploaded or imported media (poll hint 3 s; cancelable)
  • project_processing: the project pipeline up to translation (poll hint 10 s)
  • translation: retranslating segments (poll hint 5 s)
  • segment_generation: paid voicing of chosen segments into downloadable clips (poll hint 5 s)
  • dub: dubbing or redubbing (poll hint 10 s)
  • lipsync: lip-sync (poll hint 30 s)
  • onscreen: on-screen text translation (poll hint 15 s; cancelable while queued)
  • localization: dub, lip-sync and on-screen as one run with child jobs (poll hint 15 s)
  • voice_clone: creating a voice clone (poll hint 10 s)
  • export: rendering an export (poll hint 15 s)
  • file_restore: restoring archived files (poll hint 300 s)
Available options:
media_import,
project_processing,
translation,
segment_generation,
dub,
lipsync,
onscreen,
localization,
voice_clone,
export,
file_restore
status
enum<string>[]

Comma-separated statuses.

Maximum array length: 5

Job status. Monotonic: never goes backwards and never leaves a terminal state.

  • queued: accepted, not started
  • running: in progress
  • succeeded: finished; see result
  • failed: finished; see error
  • canceled: canceled, or its project was deleted (error.code = project_deleted)
Available options:
queued,
running,
succeeded,
failed,
canceled
channel
enum<string>

Only jobs started from this channel. Who started a job.

  • api: REST API v3
  • mcp: the Rask MCP server
  • system: automatic (auto-dub, on-screen auto-start, the stages of a localization run)
Available options:
api,
mcp,
system
created_after
string<date-time>

Created at or after.

limit
integer<int32>
default:20

Page size.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from next_cursor; keep the same filters on every page.

Maximum string length: 2048

Response

OK: JobList.

A page of Job (the list envelope shared by every list).

object
enum<string>
required

Always list.

Available options:
list
data
object[]
required

Items of this page.

next_cursor
string | null
required

Pass as cursor for the next page; null on the last page.

has_more
boolean
required

More items exist (a page may hold fewer than limit items while has_more is true).