Update a project's name, folder or metadata

curl --request PATCH \
  --url https://api.rask.ai/v3/projects/{project_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Q3 webinar teaser (final)",
  "metadata": {
    "owner": "marketing"
  }
}
'

{
  "object": "project",
  "id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
  "name": "Q3 webinar teaser (final)",
  "workspace_id": "b2e0c6d4-5b1a-4f7e-9a3c-2d8f1e6a7b90",
  "created_at": "2026-11-03T09:12:44Z",
  "created_by": {
    "user_id": "0d9a4e1c-7f2b-4c8d-a1e5-3b6f9c2d8e47"
  },
  "folder": {
    "id": "41aa8f3e-6c2d-4b7a-9e1f-5d3c8b0a2e61",
    "name": "Webinars"
  },
  "source_media_id": "c7d2a9e4-3b1f-4a6c-8d5e-9f0b2e7c1a63",
  "source": {
    "type": "file",
    "url": null
  },
  "media_kind": "video",
  "source_language": "en",
  "target_language": "es-es",
  "free_dubbing": false,
  "requested_dubbing_model": "v2",
  "dubbing_model": "v2",
  "dubbing_model_override_reason": null,
  "last_dub_engine": "meaning_first",
  "num_speakers": 2,
  "duration_seconds": 10,
  "source_duration_seconds": 10,
  "trimmed": false,
  "trial": false,
  "glossary": {
    "id": "e3b8d1f5-4a2c-4e9d-8b7f-2c6a0d1e9f38",
    "name": "Product terms",
    "version": 2
  },
  "translation_instructions": "Use the informal tu form.",
  "subtitles_imported": {
    "source": false,
    "target": false
  },
  "auto_dub": {
    "requested": true,
    "state": "dispatched",
    "skipped_reason": null,
    "max_minutes": 1
  },
  "onscreen_auto_start": {
    "state": "not_requested",
    "rejection_code": null,
    "rejected_at": null
  },
  "processing_state": {
    "phase": "done",
    "terminal": true,
    "run_id": 1,
    "seq": 16,
    "stage": null,
    "failure": null
  },
  "pipeline_status": "merging_done",
  "pipeline_status_at": "2026-11-03T09:22:31Z",
  "has_dubbed_output": true,
  "files_restoring": false,
  "active_jobs": [],
  "outputs": [
    {
      "object": "output",
      "kind": "source",
      "format": "mp4",
      "language": "en",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": null,
      "url": "https://storage.example.com/source.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_source.mp4"
    },
    {
      "object": "output",
      "kind": "dubbed_video",
      "format": "mp4",
      "language": "es-es",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": {
        "number": 7,
        "job_id": "91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
        "produced_at": "2026-11-03T09:22:31Z"
      },
      "url": "https://storage.example.com/dubbed_video.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_dubbed_video.mp4"
    },
    {
      "object": "output",
      "kind": "dubbed_audio",
      "format": "mp3",
      "language": "es-es",
      "available": false,
      "unavailable_reason": "not_in_plan",
      "outdated": false,
      "version": null,
      "url": null,
      "expires_at": null,
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_dubbed_audio.mp3"
    },
    {
      "object": "output",
      "kind": "dubbed_subtitles",
      "format": "srt",
      "language": "es-es",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": {
        "number": 7,
        "job_id": "91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
        "produced_at": "2026-11-03T09:20:02Z"
      },
      "url": "https://storage.example.com/dubbed_subtitles.srt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_dubbed_subtitles.srt"
    },
    {
      "object": "output",
      "kind": "lipsync_video",
      "format": "mp4",
      "language": "es-es",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": {
        "number": null,
        "job_id": "d3f05a92-6b1e-4c78-9f3d-2a7e4c8b1d56",
        "produced_at": "2026-11-03T10:02:11Z"
      },
      "url": "https://storage.example.com/lipsync_video.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_lipsync_video.mp4"
    },
    {
      "object": "output",
      "kind": "burned_subtitles_video",
      "format": "mp4",
      "language": "es-es",
      "available": false,
      "unavailable_reason": "not_generated",
      "outdated": false,
      "version": null,
      "url": null,
      "expires_at": null,
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_burned_subtitles_video.mp4"
    }
  ],
  "metadata": {
    "crm_id": "A-1042",
    "owner": "marketing"
  }
}

PATCH

projects

{project_id}

curl --request PATCH \
  --url https://api.rask.ai/v3/projects/{project_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Q3 webinar teaser (final)",
  "metadata": {
    "owner": "marketing"
  }
}
'

{
  "object": "project",
  "id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
  "name": "Q3 webinar teaser (final)",
  "workspace_id": "b2e0c6d4-5b1a-4f7e-9a3c-2d8f1e6a7b90",
  "created_at": "2026-11-03T09:12:44Z",
  "created_by": {
    "user_id": "0d9a4e1c-7f2b-4c8d-a1e5-3b6f9c2d8e47"
  },
  "folder": {
    "id": "41aa8f3e-6c2d-4b7a-9e1f-5d3c8b0a2e61",
    "name": "Webinars"
  },
  "source_media_id": "c7d2a9e4-3b1f-4a6c-8d5e-9f0b2e7c1a63",
  "source": {
    "type": "file",
    "url": null
  },
  "media_kind": "video",
  "source_language": "en",
  "target_language": "es-es",
  "free_dubbing": false,
  "requested_dubbing_model": "v2",
  "dubbing_model": "v2",
  "dubbing_model_override_reason": null,
  "last_dub_engine": "meaning_first",
  "num_speakers": 2,
  "duration_seconds": 10,
  "source_duration_seconds": 10,
  "trimmed": false,
  "trial": false,
  "glossary": {
    "id": "e3b8d1f5-4a2c-4e9d-8b7f-2c6a0d1e9f38",
    "name": "Product terms",
    "version": 2
  },
  "translation_instructions": "Use the informal tu form.",
  "subtitles_imported": {
    "source": false,
    "target": false
  },
  "auto_dub": {
    "requested": true,
    "state": "dispatched",
    "skipped_reason": null,
    "max_minutes": 1
  },
  "onscreen_auto_start": {
    "state": "not_requested",
    "rejection_code": null,
    "rejected_at": null
  },
  "processing_state": {
    "phase": "done",
    "terminal": true,
    "run_id": 1,
    "seq": 16,
    "stage": null,
    "failure": null
  },
  "pipeline_status": "merging_done",
  "pipeline_status_at": "2026-11-03T09:22:31Z",
  "has_dubbed_output": true,
  "files_restoring": false,
  "active_jobs": [],
  "outputs": [
    {
      "object": "output",
      "kind": "source",
      "format": "mp4",
      "language": "en",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": null,
      "url": "https://storage.example.com/source.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_source.mp4"
    },
    {
      "object": "output",
      "kind": "dubbed_video",
      "format": "mp4",
      "language": "es-es",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": {
        "number": 7,
        "job_id": "91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
        "produced_at": "2026-11-03T09:22:31Z"
      },
      "url": "https://storage.example.com/dubbed_video.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_dubbed_video.mp4"
    },
    {
      "object": "output",
      "kind": "dubbed_audio",
      "format": "mp3",
      "language": "es-es",
      "available": false,
      "unavailable_reason": "not_in_plan",
      "outdated": false,
      "version": null,
      "url": null,
      "expires_at": null,
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_dubbed_audio.mp3"
    },
    {
      "object": "output",
      "kind": "dubbed_subtitles",
      "format": "srt",
      "language": "es-es",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": {
        "number": 7,
        "job_id": "91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
        "produced_at": "2026-11-03T09:20:02Z"
      },
      "url": "https://storage.example.com/dubbed_subtitles.srt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_dubbed_subtitles.srt"
    },
    {
      "object": "output",
      "kind": "lipsync_video",
      "format": "mp4",
      "language": "es-es",
      "available": true,
      "unavailable_reason": null,
      "outdated": false,
      "version": {
        "number": null,
        "job_id": "d3f05a92-6b1e-4c78-9f3d-2a7e4c8b1d56",
        "produced_at": "2026-11-03T10:02:11Z"
      },
      "url": "https://storage.example.com/lipsync_video.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
      "expires_at": "2026-11-03T11:15:02Z",
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_lipsync_video.mp4"
    },
    {
      "object": "output",
      "kind": "burned_subtitles_video",
      "format": "mp4",
      "language": "es-es",
      "available": false,
      "unavailable_reason": "not_generated",
      "outdated": false,
      "version": null,
      "url": null,
      "expires_at": null,
      "subtitles_request": null,
      "filename": "Q3 webinar teaser_es-es_burned_subtitles_video.mp4"
    }
  ],
  "metadata": {
    "crm_id": "A-1042",
    "owner": "marketing"
  }
}

Updates whitelisted fields: name (not de-duplicated), folder_id (an empty string moves it to the root; folder counters stay right) and metadata (merged; a key set to an empty string is removed). Any other field fails with field_not_updatable; glossary and instructions change through updateTranslationSettings. Last writer wins (no ETag). When to use: to rename, file or tag a project. Side effects: Folder project counts follow a move. Cost: Free. Idempotency: Idempotency-Key accepted (SDKs send one); retries within 24 h replay the first response. Required scopes: projects:write Errors: folder_not_found (404), field_not_updatable (422)

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

projects:write

Headers

Idempotency-Key

string

Optional. A unique key per logical request (SDKs send a bare UUIDv4; an RFC 9651 quoted string is accepted and unquoted); reuse it unchanged on retries to replay the first response.

Required string length: 1 - 255

Pattern: ^[\x20-\x7E]+$

Path Parameters

project_id

string

required

Project id (from createProject or listProjects).

Maximum string length: 64

Body

application/json

Whitelisted project fields; any other field fails with 422 field_not_updatable. Translation settings change through updateTranslationSettings.

name

string

New name (not de-duplicated).

Required string length: 1 - 255

folder_id

string

Folder to move the project to; an empty string moves it to the root.

Maximum string length: 64

metadata

object

Merged into the stored metadata; a key set to an empty string is removed.

Show child attributes

Response

OK: Project.

A localization project: one media item localized into one target language.

object

enum<string>

required

Always project.

Available options:

project

string

required

Project id.

name

string

required

Project name.

workspace_id

string

required

Workspace id.

created_at

string<date-time>

required

Creation time.

created_by

object

required

A user reference.

Show child attributes

folder

object | null

required

Folder; null at the root.

Show child attributes

source_media_id

string | null

required

Media the project was created from.

source

object

required

Where the project's media came from.

Show child attributes

media_kind

enum<string> | null

required

Media kind.

Available options:

video,

audio

source_language

string | null

required

Source language (detected after transcription when auto).

target_language

string | null

required

Target language.

free_dubbing

boolean

required

Uses the free dubbing variant.

requested_dubbing_model

enum<string> | null

required

The model named in the create request; null when the request named none or the project was not created through v3.

Available options:

v1,

v2

dubbing_model

enum<string> | null

required

Effective dubbing model: v2 when the project runs meaning-first (settled at creation by the request, the language and whether Rask has meaning-first on for paid projects; on a trial, by the trial rule), its voices can use it (Voice.meaning_first_compatible) and it is not a free dubbing variant; otherwise v1.

Available options:

v1,

v2

dubbing_model_override_reason

enum<string> | null

required

Why dubbing_model differs from the request, or from the default v2 when the request named none; null when it does not differ.

Available options:

trial_rules,

meaning_first_disabled,

language_requires_v2,

language_not_supported,

free_dubbing

last_dub_engine

enum<string> | null

required

Engine of the last finished voiceover; null before the first one.

Available options:

meaning_first,

legacy

num_speakers

integer<int32> | null

required

Speakers.

duration_seconds

number<double> | null

required

Processed duration.

source_duration_seconds

number<double> | null

required

Original duration.

trimmed

boolean

required

The processed duration is shorter than the original.

trial

boolean

required

Created on a trial: watermarked, not redubbable.

glossary

object | null

required

Attached glossary.

Show child attributes

translation_instructions

string | null

required

Translation instructions.

subtitles_imported

object

required

Imported subtitles.

Show child attributes

auto_dub

object

required

Auto-dub settings and state. With a localization block, state is dispatched once the run starts and skipped_reason stays null; read the run's job.

Show child attributes

onscreen_auto_start

object

required

On-screen auto-start state.

Show child attributes

processing_state

object

required

Server-derived processing state of a project.

Show child attributes

pipeline_status

string

required

Raw last pipeline status (37 values). Informational only: use processing_state.

pipeline_status_at

string<date-time> | null

required

Time of the last status.

has_dubbed_output

boolean

required

A dubbed video exists.

files_restoring

boolean

required

Archived files are being restored.

active_jobs

object[]

required

Non-terminal v3 jobs of the project (work started in the web app has none; see processing_state).

Show child attributes

outputs

object[] | null

required

Downloadable outputs, as listProjectOutputs reports them (dub_payment_required included); null in lists.

Show child attributes

metadata

object

required

Client metadata (string map); never sent in webhooks.

Show child attributes

Get started

AI agents

Recipes

Concepts

Errors

Account

Usage

Catalogs

Uploads

Media

Projects

Exports

Glossaries

Jobs

Transcript

Segments

Versions

Speakers

Voices

Voice clones

Dubbing

Lipsync

Onscreen

Update a project's name, folder or metadata

Authorizations

Scopes

Headers

Path Parameters

Body

Response