Get Agent Release

GET /agent-releases/{version}

Returns the full AgentRelease object for a single published release.

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" \
  -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/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
401	Authentication required
403	Insufficient permissions
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