# Upload file

`POST /v1/files`

Upload a file for the agent to read. Without an explicit `path` the upload is an immutable managed object (OpenAI-exact). With a `path` it lands in the live project workspace. Max 50 MB. Requires `files:write`.


## Authentication

Bearer `sk-rav-...` API key in the `Authorization` header.

Full request/response schemas: https://docs.rav.chat/api-reference/files/upload-file