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

# List projects

> Returns the workspace's projects, most-recently-edited first. Soft-deleted projects are excluded. Each row carries `is_favorited` for the current user. Contained-artifact counts are not included — fetch those from the per-artifact APIs with `?project_id=`.




## OpenAPI

````yaml /openapi/projects.yaml get /projects
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:
    get:
      tags:
        - Projects
      summary: List projects
      description: >
        Returns the workspace's projects, most-recently-edited first.
        Soft-deleted projects are excluded. Each row carries `is_favorited` for
        the current user. Contained-artifact counts are not included — fetch
        those from the per-artifact APIs with `?project_id=`.
      operationId: listProjects
      parameters:
        - name: workspaceId
          in: query
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Projects list
          content:
            application/json:
              schema:
                type: object
                properties:
                  projects:
                    type: array
                    items:
                      $ref: '#/components/schemas/Project'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    Project:
      type: object
      properties:
        id:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
          nullable: true
        instructions:
          type: string
          nullable: true
        created_by:
          type: string
          format: uuid
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        is_deleted:
          type: boolean
        is_favorited:
          type: boolean
          description: >-
            Present on list responses; whether the current user has starred the
            project
    Error:
      type: object
      properties:
        error:
          type: string
  responses:
    Unauthorized:
      description: Not authenticated
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: session

````

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