Get Latest Agent Release

GET /agent-releases/latest

Returns the current desktop agent release for a release channel.

When to use this endpoint

Scenario	Why this endpoint
Resolve the current stable release	Returns the release object for the stable stream
Resolve the newest release candidate stream	Returns the release object for the latest stream
Need the current artifact metadata and download actions in one call	Returns the full AgentRelease object

Query Parameters

Parameter	Type	Default	Description
channel	string	stable	Release stream to resolve: stable, latest

Response

Returns a single AgentRelease object.

Example Request

curl -X GET "https://api.example.com/v2/agent-releases/latest?channel=stable" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Example Response

{
  "channel": "stable",
  "version": "1.8.3",
  "published_at": "2026-02-24T21:23:53.082Z",
  "notes_url": "https://github.com/Scalepad/scalepad-agent/releases/tag/v1.8.3",
  "artifacts": {
    "windows": {
      "filename": "ScalepadAgent-1.8.3.msi",
      "content_type": "application/octet-stream",
      "size_bytes": 12345678,
      "sha256": "abcdef1234567890",
      "download_url": "/v2/agent-releases/latest/download?channel=stable&platform=windows"
    },
    "macos": {
      "arm64": {
        "filename": "ScalepadAgent-1.8.3.pkg",
        "content_type": "application/octet-stream",
        "size_bytes": 23456789,
        "sha256": "123456abcdef7890",
        "download_url": "/v2/agent-releases/latest/download?channel=stable&platform=macos&arch=arm64"
      },
      "x86_64": {
        "filename": "ScalepadAgent-1.8.3.pkg",
        "content_type": "application/octet-stream",
        "size_bytes": 23456780,
        "sha256": "7890abcdef123456",
        "download_url": "/v2/agent-releases/latest/download?channel=stable&platform=macos&arch=x86_64"
      }
    }
  }
}

Error Responses

Status	Description
400	Invalid query parameters
401	Authentication required
403	Insufficient permissions
404	No release found for the requested channel
500	Server error

Example Error Response

{
  "error": {
    "code": "not_found",
    "message": "Agent release not found",
    "details": {
      "channel": "stable"
    }
  }
}

Related Endpoints

• List Agent Releases - Paginated list of releases
• Get Agent Release - Fetch one release by version
• Download Agent Artifacts - Redirect to installer artifacts