Skip to main content
Initiates deletion of a project. 
DELETE /api/v1/projects/{name}

​
Path parameters

​
name
string
required
The unique name of the project to delete.

​
Response

The response code and lifecycle behaviour depend on the project’s current phase:
Current phaseBehaviourResponse
Pending or FailedNo Docker resources exist. The project is removed from the store immediately.204 No Content
Scheduled, RunningThe project transitions to Terminating. The agent tears down all containers and Docker resources, then reports Terminated. The control plane removes the record automatically.202 Accepted
TerminatingAlready in progress. No-op — idempotent.202 Accepted

​
Terminating lifecycle

Scheduled / Running
       │
       ▼ (DELETE request)
  Terminating  ──(agent tears down containers)──▶  Terminated
                                                        │
                                           (control plane cleanup)
                                                        │
                                                        ▼
                                                  (deleted from store)
After you send a DELETE request, the project enters Terminating phase. It remains visible in the API until the agent confirms all Docker resources have been removed and the controller performs the final deletion. Poll GET /api/v1/projects/ to observe progress.

​
Example

curl -X DELETE http://localhost:8080/api/v1/projects/nginx-demo