v1

Single containers

Remove a single container

Remove a single container that is identified by container ID or name from a space (corresponding IBM Containers command: cf ic delete <container>). The container must be stopped before it can be deleted, unless the force query parameter is set to true.

delete/containers/{name_or_id}

Path parameters

name_or_idstring required

The unique identifier or name of the container that you want to delete. Run cf ic ps -a or call the GET /containers/json?all=true endpoint to review all containers in your space.

Query parameters

forceboolean

Use the force query parameter if you want to delete the container independent of their current state. The container does not need to be stopped first. To force the deletion of a container, enter force=true, force=True, or force=1. If you want to delete containers that are in a non-running state only, do either not set this query parameter, or enter force=false, force=False, or force=0.

Headers

X-Auth-Tokenstring required

The Bluemix JSON web token that you receive when logging into Bluemix. Run cf oauth-token to retrieve your access token.

X-Auth-Project-Idstring required

The unique ID of your organization space where you want to create or work with your containers. Run cf space <space_name> --guid, where <space_name> is the name of your space, to retrieve your space ID.

Response

No Content. The deletion of your container has been initiated.