Remove container
DELETE /container/<containerId>
Description
Remove a container. Only "empty" (no assets or child containers etc.) containers can be removed. If not empty, a HTTP 400 error will be returned with the reason.
Please be advised that CONTAINER_MANAGEMENT and API access privileges are requisite for the parent container.
When using a container token, it is essential that the token has been generated for the parent container.
Path parameters
| Param | Description |
|---|---|
containerId |
Container Id. |
Query parameters
none
Return codes
| Error code | Reason |
|---|---|
204 |
Success. |
400 |
Failed to remove the container. Most likely the container is not empty. |
401 |
Invalid or missing token. |
403 |
Insufficient permissions (required: API+CONTAINER_MANAGEMENT on the parent container). |
404 |
Container not found. |
Example
Curl request:
curl \
-X DELETE 'https://api.infrasonar.com/container/456' \
-H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'