Delete a deployment

DELETE

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

const url = 'https://api.aetherpush.com/v1/apps/example/deployments/example';
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 \
  --header 'Authorization: Bearer <token>'

Permanently deletes the deployment and its release history. 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

Deployment deleted.

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