---
title: "Check for main sandbox updates"
method: POST
path: "/api/apps/{app_id}/imported/main-update/check"
---

# Check for main sandbox updates

`POST /api/apps/{app_id}/imported/main-update/check`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/imported/main-update/check`
- Auth: HTTP bearer

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

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](/api-reference/get-main-sandbox-update-status) to follow it.

Checks for the same app are merged: a check within a minute of the last one, or while the app's first setup is still running, is accepted and does nothing. An update already in progress isn't interrupted; the newest commit is built after it.

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

<Note>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.</Note>

## Path parameters

- `app_id` string, required: ID of the imported app whose main sandbox to read or update.

## Response `202`

Successful Response

- AcceptedResponse
  - `accepted` boolean: Always `true`: the check was accepted.

## Other responses

- `401`: `unauthenticated`: Missing or invalid credentials, or credentials sent as an `api_key` query parameter.
- `403`: `forbidden`: You don't have editor access to this app, your API key is read-only, or you used a workspace API key.
- `404`: `not_found`: The app doesn't exist or isn't an imported app.
- `429`: `rate_limited`: More than 30 requests in a minute. Retry after `Retry-After` seconds.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-15** `99162eae7daf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/imported/main-update/check/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)