Application Revisions
Returns the revision history for an application, newest first: every deployed version with its creation time, whether it is currently serving traffic, and a deployment status derived from recent deployment events.
Use cases:
- Incident correlation: answer “did this regression start with a deploy?” by lining revision boundaries up against error/latency changes from the analytics endpoint
- Rollback context: identify the previous known-good revision
status and deployed_by are derived from the last 30 days of
deployment events; older revisions return null for both. message and
annotations are the deploy-time metadata set via fal deploy --message/--annotation; both are null when the deploy did not set them.
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.
Authorizations
Path Parameters
Query Parameters
Response
Successfully retrieved application revisions
Revision history for an application