Skip to content
AetherAether Docs

Get release history of a deployment

GET
/v1/apps/{appName}/deployments/{deploymentName}/history
curl --request GET \
  --url https://api.aetherpush.com/v1/apps/example/deployments/example/history \
  --header 'Authorization: Bearer <token>'

Returns the release history of the deployment. Without query params, returns the full history. Pass page and/or size to opt into pagination; pass startDate/endDate (Unix ms) to filter by upload time.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
appName
required
string
deploymentName
required
string

Query Parameters

Section titled “Query Parameters”
page
integer
>= 1

1-indexed page number. Triggers paginated response.

size
integer
>= 1

Items per page. Default 20.

startDate
integer format: int64

Unix timestamp in ms; releases uploaded before this are excluded.

endDate
integer format: int64

Unix timestamp in ms; releases uploaded after this are excluded.

Responses

Section titled “Responses”

200

Section titled “200”

Release history (paginated when page or size is provided).

Media typeapplication/json
object
history
required
Array<object>
object
appVersion
string
blobUrl
required

Signed URL to download the package bundle.

string format: uri
description
string
diffPackageMap

Map of source package hash to diff blob info.

object
key
additional properties
object
size
required
integer format: int64
url
required
string format: uri
isDisabled
boolean
isMandatory
boolean
label
string
manifestBlobUrl

Signed URL to the package manifest (file hash map).

string format: uri
originalDeployment

Set when releaseMethod is Promote.

string
originalLabel

Set when releaseMethod is Promote or Rollback.

string
packageHash
string
releasedBy

Account email of the releaser.

string format: email
releaseMethod
string
Allowed values: Upload Promote Rollback
rollout
integer | null
>= 1 <= 100
size
required

Package size in bytes.

integer format: int64
uploadTime

Unix timestamp in milliseconds.

integer format: int64
meta
object
totalItems
required
integer
itemCount

Number of items in the current page.

integer
itemsPerPage
required
integer
>= 1
totalPages
required
integer
>= 1
currentPage
required
integer
>= 1
Example
{
  "history": [
    {
      "appVersion": "1.0.0",
      "label": "v3",
      "releaseMethod": "Upload"
    }
  ]
}

401

Section titled “401”

Unauthenticated, or not a collaborator.

Media typeapplication/json
object
error
required

Human-readable error message.

string
requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string
Example
{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}

404

Section titled “404”

App or deployment not found.

Media typeapplication/json
object
error
required

Human-readable error message.

string
requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string
Example
{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}