# Projects

Create, monitor, and manage AI-generated video projects.

 - [POST /auth/organization/{organizationId}/workspace/{workspaceId}/projects/create](https://api-docs.shuffll.com/apis/projects/createworkspaceproject.md): Create a project in an explicitly selected organization/workspace. Uses the same request body and creation pipeline as /auth/project/create. Set toAutoEnhance and toAutoExport explicitly to control au
 - [POST /auth/organization/{organizationId}/workspace/{workspaceId}/projects/prepared](https://api-docs.shuffll.com/apis/projects/createpreparedproject.md): Materialize existing media, script, captions, and a template without AI creative generation. All scene and media-layer fields shown as required must be supplied, including explicit nulls. Captions use
 - [POST /auth/project/create](https://api-docs.shuffll.com/apis/projects/createproject.md): Create a new AI-powered video project from a prompt, URL, or script. --- ### Prompt Types | `promptType` | Description | | --- | --- | | `Prompt` | A free-text description of the video topic (defa
 - [GET /auth/project/{projectId}/create/status](https://api-docs.shuffll.com/apis/projects/getprojectcreatestatus.md): Poll this endpoint after creating a project to track AI generation progress. Returns a `status` field with one of three values: | `status` | Meaning | | --- | --- | | `STRUCTURE` | The AI is building
 - [GET /auth/project/{projectId}](https://api-docs.shuffll.com/apis/projects/getprojectbyid.md): Retrieve the full details of a specific project, including its current status, name, and workspace. Use the `status` field to determine if the project is still being generated: - `STRUCTURE` — initial
 - [DELETE /auth/project/{projectId}](https://api-docs.shuffll.com/apis/projects/deleteproject.md): Permanently delete a project and all associated data. This action cannot be undone.