Delete a project

Deletes the project softly: it refuses every change from now on, an admin key can still read it, its slug is free. Records project.deleted. Deleting a deleted project changes nothing. Admin keys only.

Parameters

Name	In	Type	Description
`project_id`required	path	string · uuid	The project’s id

Request body

None.

Responses

204

The project is deleted

No content.

401

No valid key

Problem (application/problem+json)

403

Not an admin key (forbidden)

Problem (application/problem+json)

404

No such project, or another project’s (not_found)

Problem (application/problem+json)

429

The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)

Header	Type	Description
`Retry-After`	integer	Seconds until the key’s next request passes; rounded up.

Problem (application/problem+json)

504

Postwind’s storage did not answer within its time limit (storage_timeout). A change the request makes may still take effect: check before repeating it. A repeat with the same Idempotency-Key never runs it twice: it is 409 idempotency_key_in_progress until the key’s 24 h end

Problem (application/problem+json)

bashRequest

# set POSTWIND_URL, POSTWIND_KEY and the ids first
curl -X DELETE "$POSTWIND_URL/api/v1/projects/$PROJECT_ID" \
  -H "Authorization: Bearer $POSTWIND_KEY"

MCP tool `delete_project` requires confirm

Call it: when a project is no longer used.
Needs: an admin key and confirm: true; without it the call changes nothing and tells what it would do.
Returns: outcome (would_delete, deleted, already_deleted), effect in words and the project as get_project returns it after the call; the API’s DELETE /api/v1/projects/{project_id} answers 204.

jsontools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_project",
    "arguments": {
      "project_id": "<project_id>",
      "confirm": false
    }
  }
}

Open the tool page