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

# List artifacts

> List artifacts with optional filtering by space or chat.



## OpenAPI

````yaml /api-reference/openapi.json get /api/artifacts
openapi: 3.1.0
info:
  title: Friday Platform API
  description: >-
    The Friday daemon HTTP API for managing spaces, agents, sessions, and
    automations.
  version: 1.0.0
servers:
  - url: http://localhost:18080
    description: Local Friday daemon
security: []
tags:
  - name: Health
    description: Daemon health and status
  - name: Spaces
    description: Space management
  - name: Chat
    description: Conversational AI
  - name: Sessions
    description: Execution session management
  - name: Signals
    description: Trigger management
  - name: Agents
    description: Agent discovery and inspection
  - name: Artifacts
    description: File and data artifact management
  - name: Configuration
    description: Daemon configuration
paths:
  /api/artifacts:
    get:
      tags:
        - Artifacts
      summary: List artifacts
      description: List artifacts with optional filtering by space or chat.
      operationId: listArtifacts
      parameters:
        - name: workspaceId
          in: query
          schema:
            type: string
          description: Filter by space ID
        - name: chatId
          in: query
          schema:
            type: string
          description: Filter by chat ID
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
        - name: includeData
          in: query
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
            default: 'true'
      responses:
        '200':
          description: List of artifacts
          content:
            application/json:
              schema:
                type: object
                properties:
                  artifacts:
                    type: array
                    items:
                      $ref: '#/components/schemas/Artifact'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: curl 'http://localhost:18080/api/artifacts?limit=10'
components:
  schemas:
    Artifact:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
            - file
            - summary
            - web-search
            - table
            - database
            - calendar-schedule
        name:
          type: string
        createdAt:
          type: string
          format: date-time
        revision:
          type: integer

````