Deleting Deployments

DELETE

https://Example-Server.com/be/v1/deployments/{DEPLOYMENT_NAME}

Last modified:2026-04-22 15:09:02

This endpoint deletes a deployment from the ROCKIT Edge. Deletion is only possible, if the deployment is not registered to any app.

Note, that endpoint will remove all published files from the origin storage of the specified deployment.

Required Permissions

deployments.delete

See Roles for more details.

Request

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://Example-Server.com/be/v1/deployments/gcore' \
--header 'Authorization: Bearer {{_edge_org_admin_access_token}}' \
--header 'x-rockit-orgname: ExampleOrg' \
--header 'x-rockit-username: adminPrincipal' \
--header 'x-rockit-api-key: {{_adminPrincipal_apiKey}}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "status": "success",
    "message": "deployment deleted"
}

🟠400Missing-Param

🟠409Item Protected

🟠401Unauthorized

Modified at 2026-04-22 15:09:02

Modify Deployment

Apps

Deleting Deployments

Required Permissions#

Request

Request Code Samples

Responses

Required Permissions