Push changes to GitHub

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/github/sync/manual \
  --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/manual', 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/manual",
  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/manual"

	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/manual")

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

{
  "success": true,
  "commits_pushed": true,
  "skipped": false,
  "commit_hash": "4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4",
  "error": "App not connected to GitHub",
  "duration_ms": 2860
}

GitHub

Push changes to GitHub

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

Pushes the app’s latest saved version to the connected repository.

Base44 pushes each saved version by itself while automatic sync is on. Use this when a push failed, or when you’ve turned automatic sync off, since it pushes regardless of that setting.

The push commits the app’s latest saved version on the main line, so it publishes saved work rather than the current chat turn, and it never pushes a Base44 branch.

A failed push is reported in the response body rather than as an error, so read success and error.

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

POST

api

apps

{app_id}

github

sync

manual

Push changes to GitHub

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/github/sync/manual \
  --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/manual', 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/manual",
  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/manual"

	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/manual")

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

{
  "success": true,
  "commits_pushed": true,
  "skipped": false,
  "commit_hash": "4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4",
  "error": "App not connected to GitHub",
  "duration_ms": 2860
}

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 push.

Outcome of a push to the connected repository.

success

boolean

required

Whether the push succeeded.

Example:

true

commits_pushed

boolean

required

Whether the push moved the repository forward. The value is false both when the repository already had this commit and when nothing was pushed at all.

Example:

true

skipped

boolean

required

Whether the push was skipped. This is true for exactly one reason, which is that the connection carries no GitHub App installation. Every other reason nothing was pushed comes back false, including no connection at all and a connection in error or revoked, so read error rather than this flag.

Example:

false

commit_hash

string | null

Commit pushed to the repository, or null when nothing was pushed.

Example:

"4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4"

error

string | null

Why the push didn't happen, or null when it succeeded. Plain text, not a code you can branch on.

Example:

"App not connected to GitHub"

duration_ms

integer | null

How long the push took, in milliseconds, or null when Base44 rejected the request before starting one.

Example:

2860

Base44 APIs

Apps API (Beta)

Monitoring API

Audit Logs API

Push changes to GitHub

Authorizations

Path Parameters

Response