Act on an assistant action
Acts on an actionable widget the assistant offered on a prior turn. Reference the action by its actionId from a prior assistant message. APPROVE (the default) completes the action; REJECT records the rejection. Two kinds are actionable via the API: accepting a workflow suggestion (APPROVE applies the suggested workflow and immediately starts generating; the returned assistant message carries the workflow run in generation), and applying an assistant edit (an APPLY_EDIT action with requiresApp false, which applies the edit to the project). Actions with requiresApp set to true (plans, tools, and other app-only widgets) can only be completed in the web app: open the assistant’s projectUrl instead. Asynchronous: the response contains the messageId of the resulting assistant message. Poll GET /v1/assistant-messages/{messageId} for its terminal state.
Authentication
API key from app.videogen.io/api. The full key is only shown once when you create it.
Path parameters
The assistant chat id (e.g. vg_asst_...). Every API project has one assistant chat; find it on ProjectResponse.assistantId.
The actionId of the action to act on, from a prior assistant message.
Request
Whether to approve (apply) or reject the action. Defaults to APPROVE.
Response
Opaque assistant message id for the assistant reply produced by acting on the action (e.g. vg_mesg_...). Poll GET /v1/assistant-messages/{messageId}.