VideoGen API

curl -X POST https://api.videogen.io/v1/entities/vg_enti_a1b2c3d4e5f6/update \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Maya the presenter",
  "description": "Friendly on-camera host for product explainers and demos."
}'

{
  "entityId": "vg_enti_a1b2c3d4e5f6",
  "entityType": "ACTOR",
  "name": "Maya the presenter",
  "description": "Friendly on-camera host for product explainers and demos.",
  "references": [
    {
      "fileId": "vg_file_obLD1OX2eJCrEs0071Z4kA",
      "description": "Front-facing headshot, neutral background.",
      "isDefault": true
    }
  ],
  "createdAt": 1779537600,
  "updatedAt": 1779541800,
  "actorConfig": {
    "hasVoice": true,
    "hasAvatarPresenter": true,
    "voiceDisplayName": "Matilda"
  },
  "isBuiltIn": false
}

Update an entity’s name or description. Provide at least one field. Built-in entities (isBuiltIn: true) cannot be updated.

Authentication

AuthorizationBearer

API key from app.videogen.io/api. The full key is only shown once when you create it.

API key from [app.videogen.io/api](https://app.videogen.io/api). The full key is only shown once when you create it.

Path parameters

entityIdstringRequired

The entity id (e.g. vg_enti_...).

Request

This endpoint expects an object.

namestring or nullOptional

New display name. Omit to leave unchanged.

descriptionstring or nullOptional

New description. Omit to leave unchanged.

Response

The updated entity

entityIdstring

The entity id (e.g. vg_enti_...).

entityTypeenum

ACTOR features a consistent character; PRODUCT features a consistent product or object; VISUAL_STYLE guides the look of generated images; SLIDESHOW_THEME is a shared slide design system (fonts, colors, layout) applied to every slide of a slideshow-to-video deck.

namestring

Display name.

descriptionstring

Optional description. Empty string when not set.

referenceslist of objects

Reference images attached to the entity.

createdAtinteger

Seconds since epoch (Unix timestamp) when the entity was created.

updatedAtinteger

Seconds since epoch (Unix timestamp) when the entity was last updated.

actorConfigobject or nullOptional

Voice and presenter summary for ACTOR entities. Null for non-ACTOR entities.

isBuiltInbooleanOptional

When true, this is a VideoGen catalog entity. Built-in entities cannot be updated, archived, or have references added or removed.