list_site_releases

List GitHub releases for an application, newest first.

Each release is one successful workflow run: its state (queued, fetching, published, failed), failure reason, the function snapshot and ignored-path notes it carried, and site_version_id, the version it published (null while queued or failed, for a functions-only release, and after that version is deleted). Pass a retained site_version_id to set_preview_site_version or activate_site_version. Its provenance is workflow_event (the trigger), head_repository_id and head_branch; each is null when unknown, for releases recorded before provenance was kept. A run from a branch outside the connection’s allowlist is recorded as failed with branch_not_allowed (branch_policy_unverified until the policy is verified) and never moves the preview.

Input schema

{
  "properties": {
    "application_id": {
      "title": "Application Id",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "application_id"
  ],
  "title": "list_site_releasesArguments",
  "type": "object"
}

Output schema

{
  "items": {
    "properties": {
      "attempts": {
        "type": "integer"
      },
      "created_at": {
        "type": "string"
      },
      "failure_reason": {
        "type": [
          "string",
          "null"
        ]
      },
      "function_snapshot": {
        "items": {
          "properties": {
            "name": {
              "type": "string"
            },
            "sha256": {
              "type": "string"
            },
            "size_bytes": {
              "type": "integer"
            }
          },
          "required": [
            "name",
            "sha256",
            "size_bytes"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "head_branch": {
        "type": [
          "string",
          "null"
        ]
      },
      "head_repository_id": {
        "type": [
          "integer",
          "null"
        ]
      },
      "head_sha": {
        "type": "string"
      },
      "id": {
        "type": "string"
      },
      "notes": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "run_id": {
        "type": "integer"
      },
      "run_url": {
        "type": "string"
      },
      "site_version_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "state": {
        "enum": [
          "queued",
          "fetching",
          "published",
          "failed"
        ]
      },
      "updated_at": {
        "type": "string"
      },
      "workflow_event": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "id",
      "run_id",
      "state",
      "site_version_id",
      "function_snapshot",
      "notes",
      "head_branch",
      "workflow_event",
      "head_repository_id"
    ],
    "type": "object"
  },
  "type": "array"
}