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

Your original filenames can be accessed via [REST API](/docs/api/rest/).

Make a request to receive a JSON response with file parameters including
`original_filename`.

You can set an optional filename that users will see instead of the original name:

`https://:subdomain.ucarecd.net/:uuid/:filename`

`:filename` should comply with [file name conventions](https://tools.ietf.org/html/rfc3986#section-3.3)
and it should be a valid part of a URL. For example, `filename.ext`.

Here are some examples with full CDN URLs:

```
Safe:

// adding a simple filename
https://1gkkwxp4lp.ucarecd.net/85b5644f-e692-4855-9db0-8c5a83096e25/image.jpg

// using a char allowed in the pchar definition
https://1gkkwxp4lp.ucarecd.net/85b5644f-e692-4855-9db0-8c5a83096e25/image@2x.jpg

// allowed in pchar together with Image Transformations
https://1gkkwxp4lp.ucarecd.net/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/resize/550x/image@1x.jpg

// using a sub-delim allowed in pchar together with Image Transformations
https://1gkkwxp4lp.ucarecd.net/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image_black&white@2x.jpg

// using percent-encoded gen-delims that are not allowed in pchar
https://1gkkwxp4lp.ucarecd.net/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image%5Bdesaturated%5D@2x.jpg

Unsafe:

// using gen-delims that are not allowed in pchar without encoding
https://1gkkwxp4lp.ucarecd.net/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image[desaturated]@2x.jpg
```


## API Docs

- 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/file-names/openapi.json)
- [OpenAPI YAML](https://uploadcare.com/docs/api/url/file-names/openapi.yaml)