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.

get/serverless/apps/{owner}/{name}/revisions

Path parameters

ownerstring required

Username of the app owner

Example:user_123

Username of the app owner

namestring required

Application name

Example:my-app

Application name

Query parameters

limitinteger

Maximum number of revisions to return per page (1-100)

Example:50

Maximum number of revisions to return per page (1-100)

cursorstring

Pagination cursor from previous response

Example:Mg==

Pagination cursor from previous response

Response

Successfully retrieved application revisions

next_cursorstring nullable required

Cursor for the next page of results, null if no more pages

has_moreboolean required

Boolean indicating if more results are available (convenience field derived from next_cursor)

endpoint_idstring required

Canonical endpoint identifier ('<owner>/<name>')

Example response

{
  "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"
    }
  ]
}

Changes

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