List backend functions

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

Returns the app’s deployed backend functions, each with its code and the automations that run it.

Use it to pull the functions’ source, for example before you change one and send it back with Redeploy a backend function. Every function comes back in one response, with no paging.

Set branch_id to list the functions a branch serves: main’s functions, with the ones the branch deployed in their branch version and the ones it deleted left out. Automations belong to the app, so they’re the same on every branch. When a branch can’t have functions of its own, for example on an app whose functions haven’t moved to Base44’s current function runtime, you get main’s functions.

This is limited to 60 requests per minute per app for each workspace’s personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit.

This endpoint accepts a personal API key belonging to a user with editor access to the app, including a read-only key. Workspace API keys are not accepted.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET /api/apps/{app_id}/backend-functions

List backend functions

cURL

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/backend-functions \
  --header 'Authorization: Bearer <token>'

200

{
  "functions": [
    {
      "automations": [],
      "entry": "main.ts",
      "files": [
        {
          "content": "Deno.serve(async (req) => {\n  return Response.json({ ok: true });\n});\n",
          "path": "main.ts"
        }
      ],
      "name": "sendWelcomeEmail"
    }
  ]
}

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 app the functions belong to.

Query Parameters

branch_id · string

ID of the branch to work on, as returned by List branches. Omit it to work on the app's main branch.

Response

200

application/json

The app's backend functions.

The app's deployed backend functions.

functions · BackendFunction · object[] · required

The functions, with their code and automations. Empty when the app has none.

Show child attributes

Example:

[
  {
    "automations": [],
    "entry": "main.ts",
    "files": [
      {
        "content": "Deno.serve(async (req) => {\n  return Response.json({ ok: true });\n});\n",
        "path": "main.ts"
      }
    ],
    "name": "sendWelcomeEmail"
  }
]