Serverless
Apps

List Applications

Lists the serverless applications owned by the authenticated account, with the configuration needed for follow-up calls.

Each application includes its canonical endpoint_id ('<owner>/<name>'), which is the identifier accepted by the analytics, requests, logs, and queue endpoints — use this endpoint to discover identifiers instead of asking users to paste them.

Add expand=endpoints to also include each app's registered route-level endpoint ids (e.g. '<owner>/<name>/turbo'). Multi-route apps record their requests/analytics data under these route-level ids.

Authentication: Required via API key. Only applications owned by the authenticated account are returned.

get/serverless/apps

Query parameters

environmentstring

Environment to list apps from. Defaults to the main environment.

Example:main

Environment to list apps from. Defaults to the main environment.

searchstring

Case-insensitive substring match on the app name

Example:image

Case-insensitive substring match on the app name

string
OR
string[]

Fields to expand in the response. Use endpoints to include each app's registered route-level endpoint ids.

Response

Successfully retrieved the caller's applications

Example response

{
  "apps": [
    {
      "endpoint_id": "user_123/my-app",
      "name": "my-app",
      "owner": "user_123",
      "environment": "main",
      "machine_type": "GPU-H100",
      "auth_mode": "private",
      "keep_alive": 300,
      "max_concurrency": 2,
      "request_timeout": 600,
      "startup_timeout": 300,
      "valid_regions": [
        "us"
      ],
      "updated_at": "2026-07-01T12:00:00Z",
      "endpoints": [
        "user_123/my-app",
        "user_123/my-app/turbo"
      ]
    }
  ]
}

Changes

No recorded changes to this endpoint across all 2 revisions of this API.