---
title: "Upload a file"
method: POST
path: "/files"
tags: ["Files"]
---

# Upload a file

`POST /files`

## Response `200`

Uploaded

- ApiResponseFileDetail
  - `success` boolean, required
  - `message` string, nullable
  - `timestamp` string, date-time, required
  - `data` FileDetail
    - `file` File, required
      - `id` string
      - `name` string, nullable
      - `size` integer, nullable
      - `fileType` string, nullable
      - `userId` string, nullable
      - `createdAt` string, date-time, nullable
      - `updatedAt` string, date-time, nullable
    - `parsed` FileParse
      - `fileId` string
      - `name` string
      - `fileType` string
      - `parseStatus` 'completed' | 'failed'
      - `parsedAt` string, date-time, nullable
      - `content` string, nullable
      - `error` string, nullable
      - `metadata` object
        - `pages` integer, nullable
        - `title` string, nullable
        - `totalCharCount` integer, nullable
        - `totalLineCount` integer, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/lobehub/apis/lobechat-openapi.md) · [All operations](https://skmtc.net/lobehub/apis/lobechat-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lobehub/lobechat-openapi/versions/7be2ebcf191c/schema)