> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a project

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



## OpenAPI

````yaml api-reference/openapi-v3.json DELETE /api/v3/org/owner/project/{nano_id}
openapi: 3.0.0
info:
  version: 3.0.0
  title: Composio Platform API
  description: >-
    Composio v3 API — legacy endpoints under /api/v3/. Use v3.1 for new
    integrations.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
paths:
  /api/v3/org/owner/project/{nano_id}:
    delete:
      tags:
        - Projects
      summary: Delete a project
      description: >-
        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.
      operationId: deleteOrgOwnerProjectByNanoId
      parameters:
        - schema:
            type: string
            format: projectId
            description: Unique identifier (Nano ID) of the project to delete
            example: pr_1a2b3c4d5e6f
          required: true
          description: Unique identifier (Nano ID) of the project to delete
          name: nano_id
          in: path
        - schema:
            type: boolean
            nullable: true
            default: false
            description: >-
              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.
          required: false
          description: >-
            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.
          name: revoke_on_delete
          in: query
      responses:
        '200':
          description: Project successfully deleted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                    description: Status indicating successful deletion
                    example: success
                  revoke_job_id:
                    type: string
                    description: >-
                      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: oj_1a2b3c4d5e6f
                required:
                  - status
                description: Response indicating successful project deletion
        '400':
          description: >-
            Bad request. The project ID may be invalid or in an incorrect
            format.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            Unauthorized. Authentication is required or the provided credentials
            are invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden. You do not have permission to delete this project.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            Not found. The specified project does not exist or has already been
            deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            Internal server error. An unexpected error occurred while processing
            the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - OrgApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key
    OrgApiKeyAuth:
      type: apiKey
      in: header
      name: x-org-api-key
      description: Your Composio organization API key for organization-scoped endpoints.
      x-default: your-organization-api-key

````