Clear the release history of a deployment

DELETE

/v1/apps/{appName}/deployments/{deploymentName}/history

const url = 'https://api.aetherpush.com/v1/apps/example/deployments/example/history';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

Permanently deletes all releases on the deployment. Cannot be undone. Requires the deployments.manage permission (Owner or Admin).

Authorizations

accessKeyAuth
apiKeyAuth
apps

Parameters

Path Parameters

appName

required

string

deploymentName

required

string

Responses

204

History cleared.

403

Insufficient permissions (deployments.manage required).

application/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

App or deployment not found.

application/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"
}