> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genviral.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Editor Projects

> List video editor projects in the authenticated scope, newest edit first.

Lists video editor projects in the authenticated key scope, most recently edited first. This
includes projects made in the Genviral web editor. Use [Get Editor Project](/api-reference/get-editor-project)
to read one in full.

## Query Parameters

<ParamField query="limit" type="integer" default="20">
  Page size, 1 to 50.
</ParamField>

<ParamField query="cursor" type="string">
  The `pagination.next_cursor` from the previous page.
</ParamField>

## Response

<ResponseField name="projects" type="object[]">
  Each project has `project_id`, `title`, `aspect_ratio`, `updated_at`, and `editor_url` (the
  project in the Genviral web editor). Most recently edited first.
</ResponseField>

<ResponseField name="pagination" type="object">
  `next_cursor` (string or null) and `has_more` (boolean).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://www.genviral.io/api/partner/v1/editor/projects?limit=20' \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "ok": true,
    "code": 200,
    "message": "Editor projects retrieved",
    "data": {
      "projects": [
        {
          "project_id": "b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f",
          "title": "Launch cut",
          "aspect_ratio": "9:16",
          "updated_at": "2026-10-02T12:00:00.000Z",
          "editor_url": "https://www.genviral.io/editor/b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f?workspace=personal"
        }
      ],
      "pagination": { "next_cursor": null, "has_more": false }
    }
  }
  ```
</ResponseExample>

## Error Responses

* `401` - authentication failed (missing/invalid/revoked token)
* `422 invalid_payload` - a query parameter failed validation (see `issues`)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.