# Uploadcare File names API

**Canonical:** https://apis.io/apis/uploadcare/uploadcare-file-names-api/  
**Provider:** Uploadcare — https://apis.io/providers/uploadcare/  
**Base URL:** https://api.uploadcare.com  
**Documentation:** https://uploadcare.com/api-refs/rest-api/v0.7.0/

Uploadcare File names API is one of 11 APIs that [Uploadcare](https://apis.io/providers/uploadcare/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include File names. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

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://ucarecdn.com/: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://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/image.jpg // using a char allowed in the pchar definition https://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/image@2x.jpg // allowed in pchar together with Image Transformations https://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/resize/550x/image@1x.jpg // using a sub-delim allowed in pchar together with Image Transformations https://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image_black&white@2x.jpg // using percent-encoded gen-delims that are not allowed in pchar https://ucarecdn.com/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://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image[desaturated]@2x.jpg ```

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/uploadcare/refs/heads/main/openapi/uploadcare-file-names-api-openapi.yml
- **Documentation** — https://uploadcare.com/docs/rest_api/
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/uploadcare/refs/heads/main/graphql/uploadcare-graphql.md
- **Documentation** — https://uploadcare.com/docs/api_reference/cdn/

## Other Uploadcare APIs (10)

- [Uploadcare Upload API](https://apis.io/apis/uploadcare/upload-api/)
- [Uploadcare Add-Ons API](https://apis.io/apis/uploadcare/uploadcare-add-ons-api/)
- [Uploadcare Conversion API](https://apis.io/apis/uploadcare/uploadcare-conversion-api/)
- [Uploadcare File API](https://apis.io/apis/uploadcare/uploadcare-file-api/)
- [Uploadcare File information API](https://apis.io/apis/uploadcare/uploadcare-file-information-api/)
- [Uploadcare File metadata API](https://apis.io/apis/uploadcare/uploadcare-file-metadata-api/)
- [Uploadcare Group API](https://apis.io/apis/uploadcare/uploadcare-group-api/)
- [Uploadcare Groups API](https://apis.io/apis/uploadcare/uploadcare-groups-api/)
- [Uploadcare Project API](https://apis.io/apis/uploadcare/uploadcare-project-api/)
- [Uploadcare Webhook API](https://apis.io/apis/uploadcare/uploadcare-webhook-api/)

## Tags

File names

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/uploadcare/uploadcare-file-names-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/uploadcare/.