---
title: "Legacy alias: upload files (use POST /workspaces/{workspaceId}/documents)"
method: POST
path: "/workspaces/{workspaceId}/uploads"
tags: ["Workspace"]
deprecated: true
---

# Legacy alias: upload files (use POST /workspaces/{workspaceId}/documents)

`POST /workspaces/{workspaceId}/uploads`

> **Deprecated.**

Deprecated alias for `POST /workspaces/{workspaceId}/documents` —
identical body and responses.

## Headers

- `Idempotency-Key` string

## Request body

- UploadFilesRequest
  - `files` object[], required — Per-request file cap enforced (over it → 413 TOO_MANY_FILES).
    - `filename` string, required
    - `content` string, required — Base64-encoded file bytes.
    - `mode` 'table' | 'append' | 'document' — `table` (CSV → new table; the default for `.csv`), `append` (CSV → existing table; requires `tableId`), or `document` (force document storage).
    - `tableId` string, uuid — Required when mode is `append` — the table to append CSV rows to.

## Response `201`

Per-file ingest results ({ results: [...] }).

## Other responses

- `413` — TOO_MANY_FILES.
- `422` — UPLOAD_FAILED.

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)