---
title: "Delete Project"
method: DELETE
path: "/projects/{project_id}"
tags: ["projects"]
---

# Delete Project

`DELETE /projects/{project_id}`

Soft-delete a project by setting is_deleted=True.

The project row is preserved in the database but hidden from all
read queries. Associated resources (datasets, training
jobs) remain linked and are unaffected.

The project owner can always soft-delete their own project. Other
team members must hold ``TeamPermission.DELETE_RESOURCES`` in the
project's team — granted to ``owner``, ``admin``, and ``editor``.

Args:
    project_id: Project UUID to soft-delete.
    auth: Authentication result.

Returns:
    ProjectDeleteResponse confirming the deletion.

Raises:
    HTTPException: 404 when no visible, non-deleted project matches
        ``project_id`` for the caller; 403 when the caller is not the
        project owner and lacks ``DELETE_RESOURCES``; 500 on
        transient infrastructure errors.

## Path parameters

- `project_id` string, uuid, required

## Response `200`

Successful Response

- ProjectDeleteResponse — Response model for deleting a project.
  - `success` boolean, required
  - `message` string, required
  - `project_id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)