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

# Delete a project

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

Deletes a project within the organization by its unique identifier. This affects every resource belonging to the project, including its API keys, webhook configurations, and connected services. The action cannot be undone. Pass `?revoke_on_delete=true` to also revoke the upstream credentials of every connection in the project.

## 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.

- 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.dev/composiohq/apis/composio-platform-api.md) · [All operations](https://skmtc.dev/composiohq/apis/composio-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api/revisions/5d36ffa938a0/schema)