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

# Get a project

> Single project lookup. Returns a structured `403 access_denied` (with owner name and pending-request flag) when the caller is a workspace member who lacks access to a restricted project, rather than a 404.




## OpenAPI

````yaml /openapi/projects.yaml get /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}:
    get:
      tags:
        - Projects
      summary: Get a project
      description: >
        Single project lookup. Returns a structured `403 access_denied` (with
        owner name and pending-request flag) when the caller is a workspace
        member who lacks access to a restricted project, rather than a 404.
      operationId: getProject
      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
          content:
            application/json:
              schema:
                type: object
                properties:
                  project:
                    $ref: '#/components/schemas/Project'
        '403':
          description: Access denied (caller cannot view this restricted project)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDenied'
        '404':
          $ref: '#/components/responses/NotFound'
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
    AccessDenied:
      type: object
      properties:
        error:
          type: string
          enum:
            - access_denied
        resource:
          type: object
          properties:
            id:
              type: string
              format: uuid
            type:
              type: string
              enum:
                - project
            name:
              type: string
              nullable: true
            ownerName:
              type: string
              nullable: true
            alreadyRequested:
              type: boolean
    Error:
      type: object
      properties:
        error:
          type: string
  responses:
    NotFound:
      description: Resource not found
      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.