Migrate a model

curl --request POST \
  --url https://{instance}.omniapp.co/api/v1/models/{modelId}/migrate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "gitRef": "main",
  "targetModelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "branchName": "migrate-from-prod",
  "commitMessage": "Migrate model from production"
}
'

{
  "success": true
}

Models

Migrate a model

Copies a model from one Omni connection to another by reading the source model’s YAML at a specific git ref and writing it to the target model. Supports same-organization and cross-organization migrations.

This API:

Reads the full model YAML from the source model’s git repository at the specified gitRef (merged with the default branch).
If branchName is provided and the branch already exists on the target model, the API writes to that branch. If the branch doesn’t exist, one is created.
Writes the YAML to the target model or branch, replacing its model definition.

Requirements

To successfully migrate a model:

The user performing the migration must have:
- For the source model - Querier, Modeler, or Connection Admin permissions
- For the target model - Modeler or Connection Admin permissions
- For cross-organization migrations - The user must be a member of both organizations
The source model must have git configured. This is required so the API can read the model YAML from the repository.
The target model should have an identical schema model to the source model at the instant the git ref was committed.

POST

models

{modelId}

migrate

Migrate a model

curl --request POST \
  --url https://{instance}.omniapp.co/api/v1/models/{modelId}/migrate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "gitRef": "main",
  "targetModelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "branchName": "migrate-from-prod",
  "commitMessage": "Migrate model from production"
}
'

{
  "success": true
}

Authorizations

Authorization

string

header

required

Requires an Organization API Key. Personal Access Tokens (PATs) are not supported for this endpoint.

Include in the Authorization header as: Bearer ORGANIZATION_API_KEY

Path Parameters

modelId

string<uuid>

required

The shared model ID to read YAML from.

Body

application/json

gitRef

string

required

Git reference (branch name, tag, or commit SHA) to read the source model YAML from.

Example:

"main"

targetModelId

string<uuid>

required

The shared model ID to write the YAML to.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

branchName

string

Required if the target model has git enabled.. Branch name on the target model. If the branch doesn't exist, it will be created.

Example:

"migrate-from-prod"

commitMessage

string

Git commit message.

Example:

"Migrate model from production"

Response

Model migrated successfully

success

boolean

Whether the migration completed successfully.

Example:

true

Validate model

Delete view

⌘I

Documentation Index

Authorizations

Path Parameters

Body

Response