> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://uploadcare.com/docs/api/upload/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://uploadcare.com/docs/_mcp/server.

# Uploadcare Upload API Reference

> Complete reference documentation for the Uploadcare Upload API. Covers endpoints, requests, parameters, and response examples.

Upload API provides several ways to upload files to Uploadcare servers in a secure and reliable way.

For high-level integrations and SDKs, see [available libraries](/docs/integrations/).

### File storage

Every uploaded file is **temporary** and will be deleted within 24 hours unless stored. To make a file permanent:

* On upload via the [`UPLOADCARE_STORE` flag](https://uploadcare.com/docs/api/upload/upload/base-upload)
* Use [store](https://uploadcare.com/docs/api/rest/file/store-file) or [copy](https://uploadcare.com/docs/api/rest/file/create-local-copy) via the [REST API](https://uploadcare.com/docs/api/rest/)

> **Note**
>
> **Note:** `UPLOADCARE_STORE=auto` delegates the storage decision to the project's [auto-store setting](https://app.uploadcare.com/projects/-/settings/#storage), which is enabled by default.

### File delivery

Once uploaded, files are available via the [CDN](/docs/delivery/). The CDN supports on-the-fly image processing and proxying.

### API endpoints

Upload API root endpoint: `https://upload.uploadcare.com/`

> **Note**
>
> **Note:** All API endpoints must end with a forward slash `/`.

```text
POST /base/
POST /multipart/
...
```

> Complete reference documentation for the Uploadcare Upload API. Covers endpoints, requests, parameters, and response examples.

## Docs

- [Authentication](https://uploadcare.com/docs/api/upload/authentication.md)
- [Errors](https://uploadcare.com/docs/api/upload/errors.md)

## API Docs

- Upload API > Upload [Direct uploads](https://uploadcare.com/docs/api/upload/upload/base-upload.md)
- Upload API > Upload [Start multipart upload](https://uploadcare.com/docs/api/upload/upload/multipart-file-upload-start.md)
- Upload API > Upload [Upload individual file parts](https://uploadcare.com/docs/api/upload/upload/multipart-file-upload-part.md)
- Upload API > Upload [Complete multipart upload](https://uploadcare.com/docs/api/upload/upload/multipart-file-upload-complete.md)
- Upload API > Upload [Upload files from URLs](https://uploadcare.com/docs/api/upload/upload/from-url-upload.md)
- Upload API > Upload [Check the status of a task to fetch/upload a file from a URL](https://uploadcare.com/docs/api/upload/upload/from-url-upload-status.md)
- Upload API > Upload [Get information about an uploaded file](https://uploadcare.com/docs/api/upload/upload/file-upload-info.md)
- Upload API > Groups [Create a file group](https://uploadcare.com/docs/api/upload/groups/create-files-group.md)
- Upload API > Groups [Get information about a file group](https://uploadcare.com/docs/api/upload/groups/files-group-info.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://uploadcare.com/docs/api/upload/openapi.json)
- [OpenAPI YAML](https://uploadcare.com/docs/api/upload/openapi.yaml)