Check for main sandbox updates

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/imported/main-update/check \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/imported/main-update/check"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/imported/main-update/check', 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}/imported/main-update/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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}/imported/main-update/check"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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}/imported/main-update/check")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "accepted": true
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

Imported app sessions

Check for main sandbox updates

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

Asks Base44 to check the branch the app was imported from and update the main sandbox if it moved. The request returns before the update runs, so poll Get main sandbox update status to follow it.

Base44 reads the branch at most once a minute for each app, and the checks the app editor makes while the app is open count too. A check that arrives within a minute of the last read is accepted and doesn’t read the branch again, so it can miss a commit that landed after that read. Retrying the same check is safe. If the commit you merged isn’t the one active_generation shows after a minute, call this endpoint again. A check made while the app’s first setup is still running is also accepted and does nothing. An update already in progress isn’t interrupted, and the newest commit is built after it.

This endpoint is limited to 30 requests per minute per user, reported in the X-RateLimit-* headers.

This endpoint accepts a personal API key or personal access token belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted. Send credentials in a header: an api_key query parameter is refused.

POST

api

apps

{app_id}

imported

main-update

check

Check for main sandbox updates

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/imported/main-update/check \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/imported/main-update/check"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/imported/main-update/check', 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}/imported/main-update/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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}/imported/main-update/check"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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}/imported/main-update/check")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "accepted": true
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Not found",
    "details": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "App not found",
    "details": {}
  }
}

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 imported app whose main sandbox to read or update.

Response

Successful Response

accepted

boolean

default:true

Always true: the check was accepted.

Example:

true

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Outbound webhooks

Check for main sandbox updates

Authorizations

Path Parameters

Response