> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a project

> Soft-deletes the project (flips `is_deleted`) and detaches contained pages, tables, and chats by nulling their `project_id` — the artifacts themselves survive and stay findable in the global overviews. Only the project owner or a workspace admin/owner may delete.




## OpenAPI

````yaml /openapi/projects.yaml delete /projects/{id}
openapi: 3.1.0
info:
  title: Connie Projects API
  version: 1.0.0
  description: >
    API for Projects — a workspace container that groups related chats, pages,
    flows, tables, and uploaded files under a single shared space with its own
    access model.

    A project is a lightweight grouping object: it owns a name, description, and
    AI `instructions`, plus a per-project access mode (everyone / creator-only /
    specific users). Artifacts are **not** nested under project sub-routes — a
    page, flow, table, or chat belongs to a project by carrying a `project_id`,
    set through that artifact's own API and queried back with `?project_id=...`.
    The only artifact a project stores directly is **Project Files** (binary
    uploads in the `project-files` storage bucket).
servers:
  - url: https://connie.ai/api
    description: Production
security:
  - cookieAuth: []
tags:
  - name: Projects
    description: Create, read, update, and delete projects; manage sharing and favorites
  - name: Project Files
    description: Upload, list, and delete binary files attached to a project
paths:
  /projects/{id}:
    delete:
      tags:
        - Projects
      summary: Delete a project
      description: >
        Soft-deletes the project (flips `is_deleted`) and detaches contained
        pages, tables, and chats by nulling their `project_id` — the artifacts
        themselves survive and stay findable in the global overviews. Only the
        project owner or a workspace admin/owner may delete.
      operationId: deleteProject
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: workspaceId
          in: query
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Project deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    Forbidden:
      description: Insufficient permissions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: session

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.