---
title: "List remix actions for a project"
method: GET
path: "/v1/projects/{projectId}/remix-actions"
tags: ["Projects"]
---

# List remix actions for a project

`GET /v1/projects/{projectId}/remix-actions`

Returns remix actions applied to a project (via `POST /v1/projects/{projectId}/remix` or as a post-workflow step), most recent first, with each action's status and progress. Cursor-paginated; see the [Pagination](/pagination) guide.

## Path parameters

- `projectId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Remix actions for the project.

- ListRemixActionsResponse
  - `remixActions` RemixActionRun[], required — Remix actions for the project, most recent first.
    - `remixActionId` string, required — Opaque remix action id (e.g. `vg_rmix_...`).
    - `type` 'SET_BACKGROUND_MUSIC' | 'SET_LOGO' | 'ENABLE_CAPTIONS' | 'DISABLE_CAPTIONS' | 'ADD_TRANSITIONS' | 'ADD_ZOOM' | 'RESIZE_PROJECT' | 'CLEAN_UP_TRANSCRIPT' | 'CONVERT_IMAGES_TO_VIDEOS' | 'REGENERATE_IMAGES' | 'UPSCALE_ASSETS' | 'CHANGE_NARRATOR' | 'SHUFFLE_STOCK_VISUALS' | 'GENERATE_MUSIC' | 'TRANSLATE_PROJECT', required — The kind of edit a remix action applies.
    - `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled', required — Lifecycle status shared by every asynchronous job (tool executions, workflow runs, remix actions, project exports, and timeline interchange jobs). `pending` and `running` are in-progress; `succeeded`, `failed`, and `cancelled` are terminal.
    - `projectId` string, required — Id of the project this remix action edits (e.g. `vg_proj_...`).
    - `projectUrl` string, uri, required — Deep link to open this project in the VideoGen web editor. Not required for an API-only integration: store `projectId` and use the Projects API (export, remix, metadata). Use `projectUrl` when a person should open the project in the app to review or edit it manually. The project is visible only to members of your team and any project collaborators, the same access model as a project created in the dashboard.
    - `progressPercentage` number, required — Completion progress for the current attempt (0-100). Always `100` when `status` is `succeeded`.
    - `attemptIndex` integer, required — Zero-based index of the current or most recent execution attempt.
    - `error` ApiError, required — Standard error body returned with every non-2xx response (the `default` response of every operation). The HTTP status code conveys the error class; this body carries the details: - `400` invalid request, `401` missing or invalid API key, `403` not permitted (e.g. plan or add-on required, see `requirement`), `404` not found, `409` conflict, `429` rate limited or out of credits, `5xx` server error. Common `code` values include `invalid_request`, `invalid_api_key`, `not_authorized`, `not_found`, `insufficient_credits`, and `rate_limited`. Always branch on `code` (and `requirement.type` when present) rather than parsing `message`.
      - `message` string, required — Human-readable error description. For display and logging only; do not branch on its exact text.
      - `code` string, nullable — Machine-readable error code in snake_case (e.g. `invalid_api_key`, `insufficient_credits`). `null` when no specific code applies.
      - `requirement` ErrorRequirement — What is needed to resolve an error, when it can be fixed by fulfilling a specific requirement (e.g. purchasing an add-on or upgrading the plan).
        - `type` string, required — Machine-readable requirement type in snake_case (e.g. `purchase_add_on`, `upgrade_plan`).
        - `details` object — Key-value pairs with requirement-specific context (e.g. the add-on id to purchase).
      - `internalErrorCode` string, nullable — Opaque internal error code for debugging. Include this when contacting support. `null` when not applicable.
  - `hasMore` boolean, required — When true, there are more remix actions available. Pass `nextCursor` as the `cursor` query param to fetch the next page.
  - `nextCursor` string, nullable, required — Opaque cursor to fetch the next page. `null` when `hasMore` is false.

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/videogen/apis/videogen-api.md) · [All operations](https://skmtc.dev/videogen/apis/videogen-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/videogen/videogen-api/revisions/33dda0455d67/schema)