---
title: "Upload file"
method: POST
path: "/v1/files"
tags: ["File API"]
---

# Upload file

`POST /v1/files`

Upload a new file to the system. Supports various file formats including PDF, DOC, DOCX, PPT, PPTX, JPG, PNG, EML, HTML, SRT, CSV, XLS, and XLSX.

## Query parameters

- `graphId` string, uuid

## Headers

- `Content-Disposition` string, required
- `Content-Type` string, required
- `Content-Length` integer, required

## Response `200`

- FileResponse
  - `id` string, required — A unique identifier of the file.
  - `created_at` string, date-time, required — The timestamp when the file was uploaded.
  - `name` string, required — The name of the file.
  - `graph_ids` string[], required — A list of Knowledge Graph IDs that the file is associated with. If you provided a `graphId` during upload, the file is associated with that Knowledge Graph. However, the `graph_ids` field in the upload response is an empty list. The association will be visible in the `graph_ids` list when you retrieve the file using the file retrieval endpoint.
  - `status` string, required — The processing status of the file.

## Changes

- **2025-12-01** `ea6ec4b34f6b` — 1 info
  - added the new optional `query` request parameter `graphId`
- **2024-10-03** `4a11c63c7cb5` — 3 breaking, 1 info
  - removed the media type `application/octet-stream` from the request body
  - removed the media type `audio/mpeg` from the request body
  - removed the media type `video/mp4` from the request body
  - added the media type `message/rfc822` to the request body
- **2024-09-20** `149f74d46fcb` — 2 info
  - api operation id `getewayUploadFile` removed and replaced with `gatewayUploadFile`
  - added the required property `status` to the response with the `200` status

[Change history](https://skmtc.dev/writer/apis/api/changes/v1/files/post.md)

---

[API](https://skmtc.dev/writer/apis/api.md) · [All operations](https://skmtc.dev/writer/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/writer/api/revisions/ae230e1d8c09/schema)