Uploadcare File names API
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 filenamehttps://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/image.jpg// using a char allowed in the pchar definitionhttps://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/image@2x.jpg// allowed in pchar together with Image Transformationshttps://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/resize/550x/image@1x.jpg// using a sub-delim allowed in pchar together with Image Transformationshttps://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image_black&white@2x.jpg// using percent-encoded gen-delims that are not allowed in pcharhttps://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image%5Bdesaturated%5D@2x.jpgUnsafe:// using gen-delims that are not allowed in pchar without encodinghttps://ucarecdn.com/85b5644f-e692-4855-9db0-8c5a83096e25/-/preview/-/grayscale/image[desaturated]@2x.jpg```
Uploadcare File names API is one of 11 APIs that Uploadcare publishes on the 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.
This API exposes 1 operation across 1 path. It is described by OpenAPI 3.0.0, at version 2022-11-28.
Requests are made against a single base URL, https://ucarecdn.com.
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 1
Across 1 path, the API surfaces 1 operation — 1 GET. Each is listed below with its method, path, parameters, and response codes.
Your original filenames can be accessed via [REST API](/docs/api/rest/). Make a request to receive a JSON response with file parameters including originalfilename. You can set an…
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Uploadcare 10
Other APIs Uploadcare publishes across the network.