Skip to main content
POST
Create a migration

Authorizations

x-api-key
string
header
required

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

Body

application/json
name
string
required

Display name for the migration (e.g. the customer's org name).

source
string

The source name this migration comes from. Optional — omit for a sourceless migration.

external_id
string

Your own identifier for this customer. Alphanumeric, hyphens, underscores. Makes creation idempotent.

Maximum string length: 255
Pattern: ^[a-zA-Z0-9_-]+$
templates
string[]

Template slugs to create sheets from. Omit to use every active template.

Response

The created migration (200 when an existing migration is returned via external_id idempotency).

migration
object