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

# Uploadcare URL API Reference

> Complete reference documentation for the Uploadcare's URL API. Covers endpoints, requests, their parameters, and response examples.

Every uploaded file is immediately available on the Uploadcare CDN.
The CDN includes on-the-fly processing features and can work as a proxy.

You can add CDN operations by including directives in the CDN URL:
`https://:subdomain.ucarecd.net/:uuid/-/:operation/:params/:filename`

* `:subdomain` is your project's subdomain. Find it in [Delivery](https://app.uploadcare.com/projects/-/settings/#delivery).
* `:uuid` stands for the unique file identifier, UUID, assigned on upload.
* `/-/` is a mandatory parsing delimiter to divide operations and other path components.
* `:operation/:params/` is a CDN operation directive with parameters.
* `:filename` is an optional filename you can add after a trailing slash /.

You can stack two and more operations like this:
`-/:operation/:params/-/:operation/:params/`

You don't have to code most of the low-level API interactions. We have high-level [libraries](/docs/integrations/) for all popular platforms.

### API endpoints

Access files in Uploadcare CDN at `:subdomain.ucarecd.net` over HTTP/HTTPS.

**`Endpoints`**

```text title="Endpoints"
https://:subdomain.ucarecd.net/:uuid/
https://:subdomain.ucarecd.net/:uuid/-/:operation/:params/:filename
https://:subdomain.ucarecd.net/:uuid/-/preview/
https://:subdomain.ucarecd.net/:uuid/gif2video/
https://:subdomain.ucarecd.net/:uuid/videoframe/:timestamp/
...
```

> Complete reference documentation for the Uploadcare's URL API. Covers endpoints, requests, their parameters, and response examples.

## Docs

- [File Information](https://uploadcare.com/docs/api/url/file-information.md)
- [File Names](https://uploadcare.com/docs/api/url/file-names.md)
- [File groups](https://uploadcare.com/docs/api/url/file-groups.md)
- [Image processing limitations](https://uploadcare.com/docs/api/url/image-processing-limitations.md)
- [Image compression](https://uploadcare.com/docs/api/url/image-compression.md)
- [Image resize and crop](https://uploadcare.com/docs/api/url/image-resize-and-crop.md)
- [Image rotation](https://uploadcare.com/docs/api/url/image-rotation.md)
- [Image overlays](https://uploadcare.com/docs/api/url/image-overlays.md)
- [Image colors](https://uploadcare.com/docs/api/url/image-colors.md)
- [Image definition](https://uploadcare.com/docs/api/url/image-definition.md)
- [Image recognition](https://uploadcare.com/docs/api/url/image-recognition.md)
- [Other image operations](https://uploadcare.com/docs/api/url/other-image-operations.md)
- [Proxy](https://uploadcare.com/docs/api/url/proxy.md)
- [Signed URLs](https://uploadcare.com/docs/api/url/signed-ur-ls.md)
- [CDN settings](https://uploadcare.com/docs/api/url/cdn-settings.md)
- [Integrations](https://uploadcare.com/docs/api/url/integrations.md)

## API Docs

- URL API > File Information [File info as JSON](https://uploadcare.com/docs/api/url/file-information/file-info-json.md)
- URL API > File Names [File with a custom name](https://uploadcare.com/docs/api/url/file-names/file-with-name.md)

## OpenAPI Specification

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