Delete a backend function
Changed on<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
Deletes one of the app's backend functions, along with the automations that run it.
The function is removed from the app's main line, but the published app keeps serving it until you deploy the app again with Deploy an app. Its automations are deleted straight away, so they stop for the published app too. The function's file in the app's code is left alone. The delete is rejected while main is protected. It works on main only, so naming a branch in branch_id returns a 409.
An app runs one deploy at a time, and a delete counts as one. If another deploy for the app is still running after a short wait, the call is rejected and is safe to retry. On some apps the remaining functions are redeployed as part of the delete, and the request waits for that to finish.
This is limited to 60 requests per minute per app for each workspace's API keys, so every personal and workspace API key in a workspace shares one allowance. Some workspaces have a different limit.
<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app, or a workspace API key with the apps:deploy scope. A read-only key is refused.</Note>
Request
- Base URLhttps://app.base44.com
- URLhttps://app.base44.com/api/apps/{app_id}/backend-functions/{function_name}
- Auth
- HTTP bearer
- or API key in header api_key
- or HTTP bearer
Path parameters
Name of the backend function, as name in List backend functions. Nested functions have slashes in their name, and you send those as they are.
ID of the app the function belongs to.
Query parameters
ID of the branch to work on, as returned by List branches. Omit it to work on the app's main branch.
Response
The function was deleted.
Changes
- info
added the new optional
queryrequest parameterbranch_id
- info
- info
the endpoint scheme security
WorkspaceApiKeyBearerAuthwas added to the API
- info