---
title: "Get project metadata"
method: GET
path: "/v1/projects/{projectId}"
tags: ["Projects"]
---

# Get project metadata

`GET /v1/projects/{projectId}`

Returns a simplified view of a project including its title, aspect ratio, status, and URL.

## Path parameters

- `projectId` string, required

## Response `200`

Project metadata.

- ProjectResponse — Simplified project metadata.
  - `projectId` string, required — Opaque project id (e.g. `vg_proj_...`).
  - `assistantId` string, nullable, required — Opaque id of this project's assistant conversation (e.g. `vg_asst_...`). Use with the Assistant API to send follow-up messages or list the assistant's prior messages for this project. `null` for older projects created before assistant chats were attached at creation time.
  - `title` string, required
  - `aspectRatio` AspectRatio, required — Aspect ratio as a width:height pair (e.g. 16 and 9 for 16:9). Not pixel dimensions.
    - `width` integer, required
    - `height` integer, required
  - `status` 'generating' | 'ready', required — High-level project status.
  - `createdAt` integer, required — Seconds since epoch (Unix timestamp) when the project was created.
  - `updatedAt` integer, required — Seconds since epoch (Unix timestamp) when the project was last updated.
  - `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.

## 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)