Skip to main content
POST
/
migrations
/
{migration_id}
/
runs
curl --request POST \
  --url https://app.vern.so/api/v1/migrations/{migration_id}/runs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kind": "generate"
}
'
{
  "run_id": "d4c3b2a1-9f8e-47d6-b5a4-c3d2e1f0a9b8",
  "status": "queued",
  "poll_url": "https://app.vern.so/api/v1/migrations/c0a8012e-.../runs/d4c3b2a1-9f8e-47d6-b5a4-c3d2e1f0a9b8"
}

Authorizations

​
x-api-key
string
header
required

Your Vern API key. Create one at Settings → API keys.

Path Parameters

​
migration_id
string<uuid>
required

The migration ID returned by Create a migration.

Body

application/json
​
kind
enum<string>
required
Available options:
generate,
update,
clarify,
execute
​
message
string

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

Response

The run was accepted and queued. Poll poll_url.

​
run_id
string<uuid>
​
status
string
Example:

"queued"

​
poll_url
string<uri>