VIvideogen
Entities

Update entity

Changed on

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

post/v1/entities/{entityId}/update

Request

  • Base URL
    https://api.videogen.io
  • Auth
    HTTP bearer

Path parameters

entityIdstring required

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

Request body

namestring nullable

New display name. Omit to leave unchanged.

descriptionstring nullable

New description. Omit to leave unchanged.

Response

The updated entity

entityIdstring required

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

entityType'ACTOR' | 'PRODUCT' | 'VISUAL_STYLE' | 'SLIDESHOW_THEME' | 'BRAND' | 'LOCATION' | 'PROP' required

ACTOR features a consistent character; PRODUCT features a consistent product you sell or promote; 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; BRAND holds a logo, a style guide image, and a writing style; LOCATION features a consistent place or set; PROP features a consistent background object that is not a product.

namestring required

Display name.

descriptionstring required

Optional description. Empty string when not set.

createdAtinteger required

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

updatedAtinteger required

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

isBuiltInboolean

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

Changes

  • 2976ed641a0cRevision changes
    • warning

      added the new BRAND enum value to the response property for the response status

    • warning

      added the new LOCATION enum value to the response property for the response status

    • warning

      added the new PROP enum value to the response property for the response status

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the required property // to the response with the status