---
title: "Batch upload files"
method: POST
path: "/files/batches"
tags: ["Files"]
---

# Batch upload files

`POST /files/batches`

## Response `200`

OK

- ApiResponseBatchFileUpload
  - `success` boolean, required
  - `message` string, nullable
  - `timestamp` string, date-time, required
  - `data` BatchFileUpload
    - `summary` object
      - `total` integer, required
      - `successful` integer, required
      - `failed` integer, required
    - `successful` 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
    - `failed` object[]
      - `name` string, required
      - `error` string, required

## Other responses

- `400` — Bad Request

---

[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)