Link an existing GitHub repository

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/github/link-existing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "repo_full_name": "acme/lead-tracker"
}
'

import requests

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

payload = { "repo_full_name": "acme/lead-tracker" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({repo_full_name: 'acme/lead-tracker'})
};

fetch('https://app.base44.com/api/apps/{app_id}/github/link-existing', 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/link-existing",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'repo_full_name' => 'acme/lead-tracker'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"repo_full_name\": \"acme/lead-tracker\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/github/link-existing")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"repo_full_name\": \"acme/lead-tracker\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"repo_full_name\": \"acme/lead-tracker\"\n}"

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

{
  "connection_id": "6890b1c4f2a7e3105d8a4472",
  "repo_full_name": "acme/lead-tracker",
  "repo_url": "https://github.com/acme/lead-tracker",
  "default_branch": "main",
  "last_synced_commit": "3f5d19c8cfc920e65313a0c5174e7e052d13bb2c"
}

GitHub

Link an existing GitHub repository

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

Connects an app created with the Base44 CLI to the GitHub repository that already holds its code. Base44 adopts the repository as it is, without creating one or pushing code to it.

The repository’s default branch must be main, and its base44/config.jsonc must name this app. From then on the repository is where the app’s code lives. Entities, agents, and functions you deployed with the CLI are replaced by their versions in the repository.

Before the call can succeed, the app’s owner needs:

Their GitHub account connected to Base44. This is done once, in Base44.
The Base44 GitHub App installed on the repository with write access.

When either is missing, send the user to the link in the error’s details, connect_url or install_url, then repeat the same call. A refused call changes nothing. If a response is lost, check Get GitHub connection before retrying, because a repeat after a successful link is refused.

Base44 imports the repository’s code in the background after the call returns. Pull changes from GitHub reports the app as already up to date once the import has finished.

POST

api

apps

{app_id}

github

link-existing

Link an existing GitHub repository

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/github/link-existing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "repo_full_name": "acme/lead-tracker"
}
'

import requests

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

payload = { "repo_full_name": "acme/lead-tracker" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({repo_full_name: 'acme/lead-tracker'})
};

fetch('https://app.base44.com/api/apps/{app_id}/github/link-existing', 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/link-existing",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'repo_full_name' => 'acme/lead-tracker'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"repo_full_name\": \"acme/lead-tracker\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/github/link-existing")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"repo_full_name\": \"acme/lead-tracker\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"repo_full_name\": \"acme/lead-tracker\"\n}"

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

{
  "connection_id": "6890b1c4f2a7e3105d8a4472",
  "repo_full_name": "acme/lead-tracker",
  "repo_url": "https://github.com/acme/lead-tracker",
  "default_branch": "main",
  "last_synced_commit": "3f5d19c8cfc920e65313a0c5174e7e052d13bb2c"
}

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id

string

required

ID of the app to connect to a GitHub repository.

Body

application/json

Request to link the app to a repository that already holds its code.

repo_full_name

string

required

Repository to link, as owner/repo. Its base44/config.jsonc project name must equal the app's name.

Required string length: 3 - 200

Pattern: ^[A-Za-z0-9-]+/[A-Za-z0-9._-]+$

Example:

"acme/lead-tracker"

Response

The connection Base44 stored for the app.

Result of linking an app to the repository that already holds its code.

connection_id

string

required

ID of the connection Base44 stored for this app.

Example:

"6890b1c4f2a7e3105d8a4472"

repo_full_name

string

required

Full repository name, as owner/repo.

Example:

"acme/lead-tracker"

repo_url

string

required

URL of the repository on GitHub.

Example:

"https://github.com/acme/lead-tracker"

default_branch

string

required

Branch Base44 syncs with. Always main.

Example:

"main"

last_synced_commit

string

required

Head commit of main the app was linked at.

Example:

"3f5d19c8cfc920e65313a0c5174e7e052d13bb2c"

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Outbound webhooks

Link an existing GitHub repository

Authorizations

Path Parameters

Body

Response