Projects

Delete a project

Changed on

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.

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

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/org/owner/project/{nano_id}
  • Auth
    API key in header x-org-api-key

Path parameters

nano_idstring projectId required

Unique identifier (Nano ID) of the project to delete

Example:pr_1a2b3c4d5e6f

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.

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"
}

Changes

  • 98956f31abf3Revision changes
    • info

      api operation id deleteV3_1OrgOwnerProjectByNanoId removed and replaced with deleteOrgOwnerProjectByNanoId

    • info

      api tag Organization Management removed

  • 589a7d115a5eRevision changes
    • info

      added the new optional query request parameter revoke_on_delete

    • info

      added the optional property to the response with the status