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

# Create a project

> Creates a project. `name` is the only required field; `description` and `instructions` can be added later via PATCH. `created_by` is taken from the authenticated user and cannot be overridden.




## OpenAPI

````yaml /openapi/projects.yaml post /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:
    post:
      tags:
        - Projects
      summary: Create a project
      description: >
        Creates a project. `name` is the only required field; `description` and
        `instructions` can be added later via PATCH. `created_by` is taken from
        the authenticated user and cannot be overridden.
      operationId: createProject
      parameters:
        - name: workspaceId
          in: query
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                  minLength: 1
                description:
                  type: string
                instructions:
                  type: string
                  description: >-
                    AI instructions applied to chats/flows scoped to this
                    project
      responses:
        '201':
          description: Project created
          content:
            application/json:
              schema:
                type: object
                properties:
                  project:
                    $ref: '#/components/schemas/Project'
        '400':
          description: Missing or empty name
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
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: session

````

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