---
title: "Upload a file"
method: POST
path: "/v3/documents/file"
tags: ["Ingest"]
---

# Upload a file

`POST /v3/documents/file`

Upload a file to be processed

## Response `200`

Successfully uploaded file

- object
  - `id` string, required — Unique identifier of the document
  - `status` string, required — Status of the document

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-04-17** `f09b91ede978` — 1 info
  - added the new optional request property `filepath`
- **2026-04-16** `10c98134d240` — 1 info
  - added the new optional request property `taskType`
- **2026-04-06** `cb825424a780` — 3 info
  - api tag `Ingest` added
  - api tag `Manage Documents` removed
  - added the new optional request property `containerTag`
- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-02-09** `4b4ababc7fb5` — 1 info
  - request property `containerTags` deprecated

[Full history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v3/documents/file/post.md)

---

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