Pull changes from GitHub

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/github/sync \
  --header 'api_key: <api-key>'

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/github/sync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/github/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/github/sync"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/github/sync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "synced": true,
  "already_up_to_date": false,
  "commits_pulled": 2,
  "latest_commit_hash": "4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4",
  "commits": [
    {
      "author_email": "dana@example.com",
      "author_name": "Dana Levi",
      "message": "Fix the lead scoring rounding",
      "sha": "4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4",
      "short_sha": "4c7e1f9",
      "timestamp": "2026-08-15T09:08:41+00:00",
      "url": "https://github.com/base44/lead-tracker/commit/4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4"
    }
  ],
  "files_summary": {
    "total_files": 7,
    "files_with_content": 6,
    "files_metadata_only": 1,
    "files_deleted": 1,
    "total_additions": 214,
    "total_deletions": 31
  },
  "error": "merge_conflict",
  "error_message": "Merge conflict while applying the pulled commits",
  "duration_ms": 4120
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Pull changes from GitHub

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Pulls new commits from the connected repository into the app.

Call this after someone pushes to the repository, or before reading the app’s code, to bring Base44 up to date. It compares the repository’s head with the last commit Base44 pulled, applies the diff to the app’s files, updates the app’s sandbox, and records the new head. With nothing new to apply it returns synced: false and already_up_to_date: true.

A failed pull still returns HTTP 200. Read synced and error instead of the status code. An app with no active connection comes back synced: false with error: not_connected rather than a 404.

error: merge_conflict means the repository’s commits and the app’s own changes touch the same lines. Hand it to Resolve GitHub sync conflicts. sync_in_progress means another pull, or a builder turn, holds the app right now, so retry it. On any error Base44 leaves the commit it last pulled where it was, so the next pull starts over from the same place rather than skipping the commits that failed.

This endpoint allows 20 requests per minute per caller, shared with Resolve GitHub sync conflicts.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

POST

api

apps

{app_id}

github

sync

Pull changes from GitHub

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/github/sync \
  --header 'api_key: <api-key>'

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/github/sync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/github/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/github/sync"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/github/sync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "synced": true,
  "already_up_to_date": false,
  "commits_pulled": 2,
  "latest_commit_hash": "4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4",
  "commits": [
    {
      "author_email": "dana@example.com",
      "author_name": "Dana Levi",
      "message": "Fix the lead scoring rounding",
      "sha": "4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4",
      "short_sha": "4c7e1f9",
      "timestamp": "2026-08-15T09:08:41+00:00",
      "url": "https://github.com/base44/lead-tracker/commit/4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4"
    }
  ],
  "files_summary": {
    "total_files": 7,
    "files_with_content": 6,
    "files_metadata_only": 1,
    "files_deleted": 1,
    "total_additions": 214,
    "total_deletions": 31
  },
  "error": "merge_conflict",
  "error_message": "Merge conflict while applying the pulled commits",
  "duration_ms": 4120
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose GitHub sync this affects.

Response

The outcome of the pull.

Outcome of a pull from the connected repository.

synced

boolean

required

Whether this call applied new commits to the app.

Example:

true

already_up_to_date

boolean

required

true when the repository's head was already the last commit Base44 pulled, so there was nothing to do.

Example:

false

commits_pulled

integer

required

How many commits commits holds, so commits Base44 pushed itself aren't counted. 0 when nothing was pulled.

Example:

2

latest_commit_hash

string | null

Repository head after the pull, or null when nothing was pulled.

Example:

"4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4"

commits

GitHubPulledCommit · object[]

The commits this call applied, oldest first. Commits Base44 pushed itself are left out, so a pull of only those comes back with an empty list.

Show child attributes

Example:

[
  {
    "author_email": "dana@example.com",
    "author_name": "Dana Levi",
    "message": "Fix the lead scoring rounding",
    "sha": "4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4",
    "short_sha": "4c7e1f9",
    "timestamp": "2026-08-15T09:08:41+00:00",
    "url": "https://github.com/base44/lead-tracker/commit/4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4"
  }
]

files_summary

GitHubPulledFiles · object | null

Change counts for the pulled commits, or null when nothing was pulled.

Show child attributes

error

string | null

Why the pull didn't happen, or null when it succeeded. One of not_connected, no_installation, sync_in_progress, connection_error, merge_conflict, sandbox_sync_failed, rate_limit_exceeded, rate_limit_low, github_api_error or unexpected_error.

Example:

"merge_conflict"

error_message

string | null

Human-readable explanation of error, or null when the pull succeeded.

Example:

"Merge conflict while applying the pulled commits"

duration_ms

integer | null

How long the pull took, in milliseconds. null when Base44 recorded no duration for it.

Example:

4120

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Pull changes from GitHub

Authorizations

Path Parameters

Response