List Applications
Changed onLists 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.
Required permissions: serverless:apps:read. Key presets that include them: SERVERLESS, DEPLOY, READONLY, FULL. See key permissions.
Request
- Base URLhttps://api.fal.ai/v1
- URLhttps://api.fal.ai/v1/serverless/apps
- AuthAPI key in header Authorization
Query parameters
Environment to list apps from. Defaults to the main environment.
Case-insensitive substring match on the app name
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
- info
the endpoint scheme security
readonlyApiKeywas added to the API - info
the endpoint scheme security
apiKeywas removed from the API
- info