---
title: "Delete a project"
method: DELETE
path: "/api/v3.1/org/owner/project/{nano_id}"
tags: ["Projects", "Organization Management"]
---

# Delete a project

`DELETE /api/v3.1/org/owner/project/{nano_id}`

Soft-deletes a project within the organization by its unique identifier. When a project is deleted, it is marked as deleted but not immediately removed from the database. This operation affects all resources associated with the project including API keys, webhook configurations, and connected services. This action cannot be undone through the API. Pass `?revoke_on_delete=true` to also revoke the upstream credentials of every connection in the project via a background job.

## Path parameters

- `nano_id` string, projectId, required — Unique identifier (Nano ID) of the project to delete

## Query parameters

- `revoke_on_delete` boolean, nullable — When `true`, the delete also starts a background job that revokes the upstream credentials of every connected account in scope, and the response carries a `revoke_job_id`. Defaults to `false`. Revocation is irreversible — recovering a deleted entity does not restore working credentials.

## Response `200`

Project successfully deleted. The project has been marked as deleted in the system.

- object — Response indicating successful project deletion
  - `status` 'success', required — Status indicating successful deletion
  - `revoke_job_id` string — Identifier of the background revoke job started for this delete. Present only when `revoke_on_delete=true`. Track the job and its per-connection results from the Composio dashboard — a programmatic endpoint to poll this job is not yet generally available.

## Other responses

- `400` — Bad request. The project ID may be invalid or in an incorrect format.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `403` — Forbidden. You do not have permission to delete this project.
- `404` — Not found. The specified project does not exist or has already been deleted.
- `500` — Internal server error. An unexpected error occurred while processing the request.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)