---
title: "Upload Document"
method: POST
path: "/brain/{brain_id}/documents/file"
tags: ["Brain"]
---

# Upload Document

`POST /brain/{brain_id}/documents/file`

## Path parameters

- `brain_id` string, required

## Response `200`

- Document
  - `brain_id` string, required — A unique identifier for the “brain” associated with this document or data object
  - `created_at` string, required — The timestamp indicating when the document or file was created
  - `document_id` string, required — A unique identifier for the document associated with this object
  - `id` integer, required — An internal ID for this object
  - `name` string, required — The name of the file or document
  - `status` string, required — The current status of the document processing.
  - `type` string, required — The type of the document or file
  - `url` string, required — A URL link to access or download the file. This is likely a temporary signed URL from AWS S3, as it includes authentication details and an expiration timestamp
  - `metadata` object, nullable, required — Identifier for metadata object
    - `language_code` string, required — Identifier for ISO language code
    - `original_url` string, required — Identifier of the url for the original file
    - `original_object` string, required — URL link to access original object
    - `processed` boolean, required — Boolean to check whether the file is processed

## Other responses

- `400`
- `500`

---

[API](https://skmtc.dev/byteleaphq/apis/athena-copy.md) · [All operations](https://skmtc.dev/byteleaphq/apis/athena-copy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/byteleaphq/athena-copy/revisions/4eb764a8d0ce/schema)