Delete project

Initiates deletion of a project.

DELETE /api/v1/projects/{name}

Path parameters

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 phase	Behaviour	Response
`Pending` or `Failed`	No Docker resources exist. The project is removed from the store immediately.	`204 No Content`
`Scheduled`, `Running`	The 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`
`Terminating`	Already 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

{
  "title": "Not Found",
  "detail": "project not found: nginx-demo",
  "status": 404,
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"
}

Overview

Nodes

Projects

Path parameters

Response

Terminating lifecycle

Example

​Path parameters

​Response

​Terminating lifecycle

​Example

Path parameters

Response

Terminating lifecycle

Example