API ReferenceProjects

Delete a projectv3.0

DELETE
/api/v3/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.

Authorization

OrgApiKeyAuth
x-org-api-key<token>

Organization API key authentication

In: header

Path Parameters

nano_idstringRequired

Unique identifier (Nano ID) of the project to delete

Format: projectId

Query Parameters

revoke_on_deletenullable boolean

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.

Default: false

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://backend.composio.dev/api/v3/org/owner/project/pr_1a2b3c4d5e6f"
{
  "status": "success",
  "revoke_job_id": "oj_1a2b3c4d5e6f"
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
Edit this page on GitHub