v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB

Projects

Organization Management

Delete a project

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.

delete/api/v3.1/org/owner/project/{nano_id}

Path parameters

nano_idstring projectId required

Unique identifier (Nano ID) of the project to delete

Example:pr_1a2b3c4d5e6f

Unique identifier (Nano ID) of the project to delete

Query parameters

revoke_on_deleteboolean 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

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

status'success' required

Status indicating successful deletion

revoke_job_idstring

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.

Example response

{
  "status": "success",
  "revoke_job_id": "oj_1a2b3c4d5e6f"
}