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

# Upload file as artifact

> Upload a file and convert it to an artifact.



## OpenAPI

````yaml /api-reference/openapi.json post /api/artifacts/upload
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/upload:
    post:
      tags:
        - Artifacts
      summary: Upload file as artifact
      description: Upload a file and convert it to an artifact.
      operationId: uploadArtifact
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - file
              properties:
                file:
                  type: string
                  format: binary
                chatId:
                  type: string
                workspaceId:
                  type: string
      responses:
        '200':
          description: File uploaded
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  artifact:
                    $ref: '#/components/schemas/Artifact'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl -X POST http://localhost:18080/api/artifacts/upload \
              -F 'file=@report.csv' \
              -F 'workspaceId=my-space-id'
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

````