Skip to main content
POST
/
v1
/
models
/
{modelId}
/
git
/
commit
Create or update a pull request for a model branch
curl --request POST \
  --url https://{instance}.omniapp.co/api/v1/models/{modelId}/git/commit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "branch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "commit_message": "Add new customer dimension",
  "allow_branch_exists": true,
  "require_branch_exists": false
}
'
{
  "pr_url": "https://github.com/myorg/repo/compare/main...feature?expand=1",
  "git_sha": "abc123def456",
  "in_sync": true,
  "did_sync": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.omni.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Path Parameters

​
modelId
string<uuid>
required

The unique identifier of the shared model.

Body

application/json
​
branch_id
string<uuid>
required

UUID of the Omni branch to commit.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
commit_message
string
required

Commit message for the git commit.

Example:

"Add new customer dimension"

​
allow_branch_exists
boolean
default:true

Set false to fail if git branch already exists (Create-only mode).

Example:

true

​
require_branch_exists
boolean
default:false

Set true to fail if git branch doesn't exist (Update-only mode).

Example:

false

Response

Commit operation completed successfully

​
pr_url
string

URL of the created or updated pull request.

Example:

"https://github.com/myorg/repo/compare/main...feature?expand=1"

​
git_sha
string

The git SHA of the commit.

Example:

"abc123def456"

​
in_sync
boolean

Whether the shared model is currently in sync with its configured default git branch.

Example:

true

​
did_sync
boolean

Whether a sync operation was performed between the shared model and its configured default git branch.

Example:

true