Skip to main content
GET
Get a media item
An item exists once its media_import job has succeeded; a failed import is on the job’s error. When to use: to check that media is ready before createProject. Side effects: None. Cost: Free. Idempotency: safe and pure (never writes); retry freely. Required scopes: media: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

media:read

Path Parameters

media_id
string
required

Media id.

Maximum string length: 64

Response

OK: Media.

A media item of the workspace (uploaded or imported through v3).

object
enum<string>
required

Always media.

Available options:
media
id
string
required

Media id.

status
enum<string>
required

Media status. An item exists once its media_import job has succeeded.

  • ready: usable
Available options:
ready
kind
enum<string> | null
required

Null until probed.

Available options:
video,
audio
purpose
enum<string>
required

What a media item is for.

  • project_source: the source of a project (default)
  • voice_sample: a sample for createVoiceClone (audio, or video whose audio is extracted to MP3 on import)
Available options:
project_source,
voice_sample
filename
string | null
required

File name.

content_type
string | null
required

Content type.

size_bytes
integer<int64> | null
required

Size.

duration_seconds
number<double> | null
required

Duration.

video
object | null
required

Video metadata.

audio
object | null
required

Audio metadata.

source
object
required

Where the media came from.

import_job_id
string | null
required

The media_import job.

error
object | null
required

Always null today, because an item exists once its import has succeeded; a failed import is on the job.

created_at
string<date-time>
required

Creation time.

ready_at
string<date-time> | null
required

When it became ready.