Get Agent Release

GET /v2/agent-releases/{version}

Returns the full AgentRelease object for a single published release.

This endpoint is unauthenticated and does not require an API token.

When to use Get Agent Release vs Get Latest Agent Release

Use case	Endpoint
Resolve the current release for a channel	GET /agent-releases/latest
Fetch a known published version directly	GET /agent-releases/{version}
Browse release history	GET /agent-releases

Path Parameters

Parameter	Type	Description
version	string	Published release version

Query Parameters

Parameter	Type	Default	Description
channel	string	stable	Release stream context for the response: stable, latest

Response

Returns a single AgentRelease object.

Example Request

curl -X GET "https://api.example.com/v2/agent-releases/1.8.3"

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/1.8.3/download?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/1.8.3/download?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/1.8.3/download?platform=macos&arch=x86_64"
      }
    }
  }
}

Error Responses

Status	Description
400	Invalid query parameters
404	Agent release not found
500	Server error

Example Error Response

{
  "error": {
    "code": "not_found",
    "message": "Agent release not found",
    "details": {
      "version": "1.8.3"
    }
  }
}

Related Endpoints

• Get Latest Agent Release - Resolve the current release for a channel
• List Agent Releases - Paginated list of releases
• Download Agent Artifacts - Redirect to installer artifacts