Auto Content Engine

An Auto Content Engine is the top-level workspace that contains everything needed to produce videos:

Sheet — the data grid (columns, rows, cells) where you write scripts, assign voices, etc.
Video composition — layers (text, sound, clip overlays) that make up each video
Automations — pipelines with triggers and actions
Global variables — template values for dynamic substitution
Final video — the rendered output

Response schema

{
  "id": 100,
  "slug": "my-first-engine",
  "title": "March Campaign",
  "project_type": "spreadsheet_v2",
  "is_default": false,
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "active",
  "created_at": "2026-03-01T12:00:00.000Z",
  "created_at_ts": 1709294400000,
  "updated_at_ts": 1709380800000,
  "spreadsheet_columns": [],
  "spreadsheet_rows": [],
  "global_variables_sheet": null
}

The spreadsheet_columns and spreadsheet_rows arrays are populated when fetching a single engine. The global_variables_sheet is null unless variables have been imported.

Create

Creates a new Auto Content Engine for the specified agent.

POST /v1/vidsheet?agent_id={agent_id}

Request body

Field	Type	Required	Description
`spreadsheet.title`	string	Yes	Name for the engine.
`spreadsheet.is_default`	boolean	No	Set as the agent’s default engine. Defaults to `false`.

Response (201)

Returns the created engine object.

Example

curl -X POST "https://api.gen.pro/v1/vidsheet?agent_id=42" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"spreadsheet": {"title": "March Campaign"}}'

{
  "id": 101,
  "slug": "march-campaign",
  "title": "March Campaign",
  "project_type": "spreadsheet_v2",
  "is_default": false,
  "uuid": "f1e2d3c4-b5a6-7890-fedc-ba0987654321",
  "status": "active",
  "created_at": "2026-03-09T10:00:00.000Z",
  "created_at_ts": 1741510800000,
  "updated_at_ts": 1741510800000,
  "spreadsheet_columns": [],
  "spreadsheet_rows": [],
  "global_variables_sheet": null
}

Errors

Status	Error code	Description
`401`	`unauthorized`	Invalid API key.
`422`	`validation_error`	Missing title or invalid parameters.

Get

Returns a single Auto Content Engine with all its columns, rows, cells, and layers.

GET /v1/vidsheet/{id}?agent_id={agent_id}

Path parameters

Parameter	Type	Description
`id`	integer	The engine ID.

Query parameters

Parameter	Type	Required	Description
`agent_id`	integer	Yes	The agent that owns this engine.
`with_execution_cost`	boolean	No	Include credit cost breakdowns on cells and layers.

Response

Returns the full engine object including nested spreadsheet_columns, spreadsheet_rows (each containing spreadsheet_cells), and global_variables_sheet.

Example

curl "https://api.gen.pro/v1/vidsheet/101?agent_id=42&with_execution_cost=true" \
  -H "X-API-Key: your-api-key"

Duplicate

Use gen_discover, then call gen_vidsheet_action with action: "duplicate" and target.kind: "vidsheet". See Work with a Vidsheet for the current schema.

Rename

Updates the title of an Auto Content Engine. PUT and PATCH are equivalent.

PATCH /v1/vidsheet/{id}?agent_id={agent_id}

Path parameters

Parameter	Type	Description
`id`	integer or uuid	The engine ID.

Request body

Field	Type	Required	Description
`project.title`	string	Yes	New name for the engine.
`project.is_default`	boolean	No	Set as the agent’s default engine. Clears the flag on the agent’s other engines.

Response (200)

Returns the updated engine object (id, uuid, title, is_default, timestamps) without nested columns or rows.

Example

curl -X PATCH "https://api.gen.pro/v1/vidsheet/101?agent_id=42" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"project": {"title": "April Campaign"}}'

Errors

Status	Error code	Description
`404`	`project_not_found`	Engine not found or agent does not have access.
`422`	`validation_error`	Missing or blank title.

Delete

Permanently deletes an Auto Content Engine together with all of its columns, rows, cells, layers, global variables, and automations. This cannot be undone. Rendered output resources are detached, not deleted (see Download).

DELETE /v1/vidsheet/{id}?agent_id={agent_id}

Path parameters

Parameter	Type	Description
`id`	integer or uuid	The engine ID to delete.

Response (200)

Empty body.

Example

curl -X DELETE "https://api.gen.pro/v1/vidsheet/101?agent_id=42" \
  -H "X-API-Key: your-api-key"

Errors

Status	Error code	Description
`404`	`project_not_found`	Engine not found or agent does not have access.