Import a GitHub branch
Adopts a branch that already exists in the connected repository as a Base44 branch.
The new branch works on that GitHub ref as it is: its turns commit to the same branch name, and Base44 never creates a separate ref for it. Its starting files, routes and entity schemas come from the ref’s tree at the head commit this call resolves, so an entity that only the branch declares is live in its preview right away.
Send a branch that exists in the repository and isn’t its default branch, which is already the app’s main chat. The name has to be free among the app’s active and merged branches, so a branch can be imported once.
If the call can’t read the branch’s files it changes nothing, so retry it.
Authorizations
Personal API key.
Path Parameters
ID of the app to import the branch into.
Body
Request to import a branch that already exists in the connected repo.
Name of the branch to import, as it exists in the connected repository. Can't be the repository's default branch.
1 - 255"feature/reporting"
Response
The imported branch.
The Base44 branch created from an existing GitHub branch.
ID of the new Base44 branch.
"68b1c0d4e7b91d003c45a1f7"
The GitHub branch name, stored exactly as you sent it. Base44's own commits go to this same branch.
"feature/reporting"
ID of the branch's own builder conversation. The branch's chat history is separate from the app's main chat.
"68b1c0d4e7b91d003c45a1f8"
Commit where the branch forked off the repository's default branch.
"9f2c1ab7d4e58036bb1f4c0a7de92b41c0d5e8a3"
Head commit of the GitHub branch at the moment it was imported.
"4c7e1f90ab3d5628e1a0f7b24c9d8e6350a1b2c4"
When the branch was created, in ISO 8601 with a UTC offset.
"2026-08-15T09:10:00.123456+00:00"