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.

{
  "endpoint_id": "user_123/my-app",
  "revisions": [
    {
      "revision_id": "my-app-a1b2c3d4",
      "created_at": "2026-07-01T12:00:00Z",
      "is_current": true,
      "message": "a1b2c3d fix cold-start",
      "annotations": {
        "GIT_SHA": "a1b2c3d4"
      },
      "status": "deployed",
      "deployed_by": "user_123"
    }
  ]
}