---
title: "Upload Workspace File"
method: POST
path: "/studio/v1/library/files"
tags: ["Library management"]
---

# Upload Workspace File

`POST /studio/v1/library/files`

Upload files to use for [RAG Engine document searches](https://docs.ai21.com/docs/rag-engine-overview).
You can assign metadata to your files to limit searches to specific files by file metadata.
There is no bulk upload method; files must be loaded one at a time.

- **Max number of files:** No limit. The playground limits bulk uploads to 50 files per request.
- **Max library size:** 1 GB total size. No limit to individual file size.
- **Supported file types:** PDF, DocX, HTML, TXT

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ai21/apis/ai21-studio-api.md) · [All operations](https://skmtc.net/ai21/apis/ai21-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ai21/ai21-studio-api/versions/4105747cd57d/schema)
