Sign in

Delete a backend function

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

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>

delete/api/apps/{app_id}/backend-functions/{function_name}

Path parameters

function_namestring required

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.

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.

app_idstring required

ID of the app the function belongs to.

ID of the app the function belongs to.

Response

The function was deleted.

Changes

Changed in 1 of the 38 revisions of this API.1