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

File metadata is additional, arbitrary data, associated with uploaded file. As an example, you could store unique file identifier from your system.

Metadata is key-value data. You can specify up to 50 keys, with key names up to 64 characters long and values up to 512 characters long.
Read more in the [docs](/docs/file-metadata/).

**Notice:** Do not store any sensitive information (bank account numbers, card details, etc.) as metadata.

**Notice:** File metadata is provided by the end-users uploading the files and can contain symbols unsafe in, for example, HTML context. Please escape the metadata before use according to the rules of the target runtime context (HTML browser, SQL query parameter, etc).


## API Docs

- File Metadata [Get file's metadata](https://uploadcare.com/docs/api/rest/file-metadata/file-metadata.md)
- File Metadata [Get metadata key's value](https://uploadcare.com/docs/api/rest/file-metadata/key.md)
- File Metadata [Update metadata key's value](https://uploadcare.com/docs/api/rest/file-metadata/update-file-metadata-key.md)
- File Metadata [Delete metadata key](https://uploadcare.com/docs/api/rest/file-metadata/delete-file-metadata-key.md)

## OpenAPI Specification

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