Application Events
Changed onReturns the operational event history for an application: deployments, configuration changes, and runner lifecycle transitions (started, failed, draining, etc.), newest first.
Use cases:
- Incident correlation: answer "what changed around this time?" — did a deploy, config change, or runner failure coincide with an error spike?
- Deployment audit: see when revisions went out and who triggered them
Time range: defaults to the last 24 hours when start/end are omitted. Use category filters to narrow to specific event types.
Authentication: Required via API key. Only the app owner can query it.
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/{owner}/{name}/events
- AuthAPI key in header Authorization
Path parameters
Username of the app owner
Application name
Query parameters
Maximum number of events to return per page (1-1000)
Pagination cursor from previous response
Response
Successfully retrieved application events
Example response
{
"endpoint_id": "user_123/my-app",
"events": [
{
"event_id": "a1b2c3d4-0000-0000-0000-000000000000",
"category": "deployment_started",
"created_at": "2026-07-01T12:00:00Z",
"payload": {
"job_id": "5f8e9c2a",
"machine_type": "GPU-H100",
"state": "RUNNING",
"actor": {
"nickname": "user_123",
"full_name": "Ada Lovelace"
}
}
}
]
}Changes
- info
the endpoint scheme security
readonlyApiKeywas added to the API - info
the endpoint scheme security
apiKeywas removed from the API
- info