> ## 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 project files

> Returns the project's files newest-first, each with a freshly signed download URL (1-hour TTL — re-fetch rather than persist). Paginated (default 50, max 100). Requires view access.




## OpenAPI

````yaml /openapi/projects.yaml get /projects/{id}/files
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}/files:
    get:
      tags:
        - Project Files
      summary: List project files
      description: >
        Returns the project's files newest-first, each with a freshly signed
        download URL (1-hour TTL — re-fetch rather than persist). Paginated
        (default 50, max 100). Requires view access.
      operationId: listProjectFiles
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: workspaceId
          in: query
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Project files
          content:
            application/json:
              schema:
                type: object
                properties:
                  files:
                    type: array
                    items:
                      $ref: '#/components/schemas/ProjectFile'
                  pagination:
                    type: object
                    properties:
                      limit:
                        type: integer
                      offset:
                        type: integer
                      total:
                        type: integer
                        nullable: true
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    ProjectFile:
      type: object
      properties:
        id:
          type: string
          format: uuid
        project_id:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        file_name:
          type: string
        mime_type:
          type: string
          nullable: true
        file_size:
          type: integer
        storage_path:
          type: string
        uploaded_by:
          type: string
          format: uuid
        created_at:
          type: string
          format: date-time
        signed_url:
          type: string
          format: uri
          nullable: true
          description: Short-lived (1-hour) signed download URL
    Error:
      type: object
      properties:
        error:
          type: string
  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'
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: session

````

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