VEvern-so
Runs

Start a run

Changed on

Start one managed-agent run. generate authors the recipe and stops at a preview; update edits it per message; clarify asks a read-only question; execute runs the approved preview for real. generate opens a preview run and update/clarify/execute resume that same run, so the run_id stays stable from preview through execution (a resuming call returns status: "running"). Only one run runs at a time per migration (409 with the active run_id otherwise).

post/migrations/{migration_id}/runs

Request

Request body

kind'generate' | 'update' | 'clarify' | 'execute' required
messagestring

Required for update and clarify — your instruction or question in plain language.

extract_via_apiboolean

generate only. Controls live API extraction from a connected source: true extracts via the connection (alongside any files), false forces file-only, omitted extracts via API only when no files were uploaded and a connection exists.

instructionsstring nullable

generate only. Optional guidance for this migration (at most 200 characters), e.g. "Only import active customers". The agent follows it but it cannot override Vern's rules, a locked template or the Memory setting. Kept for every later leg of the run and returned on the run as instructions. Longer than 200 characters returns 400 with code instructions_too_long.

Response

The run was accepted. A generate is queued; a resuming update/clarify/execute is running. Poll poll_url.

run_idstring uuid
statusstring
poll_urlstring uri

Example response

{
  "status": "queued"
}

Changes

  • 9293d74a6a03Revision changes
    • info

      added the new optional request property

  • 88ecf83c848fRevision changes
    • breaking

      added to the response body oneOf list for the response status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status