---
title: "Upload Document to Thread"
method: POST
path: "/threads/{thread_id}/documents"
tags: ["Documents"]
---

# Upload Document to Thread

`POST /threads/{thread_id}/documents`

Upload a document to be associated with a specific thread and processed for RAG. Supported file types: **Documents** (.pdf, .doc, .docx, .ppt, .pptx, .xls, .xlsx), **Text/Data** (.txt, .csv, .md, .markdown, .json, .jsonl, .xml), **Code** (.py, .js, .ts, .jsx, .tsx, .html, .css, .cpp, .c, .h, .java, .go, .rs, .rb, .php, .sql), **Images** (.png, .jpg, .jpeg, .webp, .gif, .bmp, .tiff, .tif).

## Path parameters

- `thread_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x_session_token` string, nullable

## Response `200`

Successful Response

- DocumentRead
  - `metadata_` object, nullable
  - `document_id` string, uuid, required
  - `filename` string, required
  - `status` 'pending' | 'processing' | 'indexed' | 'error', required
  - `status_message` string, nullable
  - `summary` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

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