> This page is for Developer Documentation.

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

## \[BETA] Changes to `name` and `filename` fields

The `name` and `filename` fields returned from the `GET /v2-beta/files` endpoint will correspond to the in-app display name and the original name of the uploaded file, respectively. This change will go live on **February 8th 2024**.

### What’s changing?

Responses returned from `/v2-beta/files` endpoints include both a `name` and a `filename` field. When creating files via the Benchling API, `name` is a required field and is used to populate both the filename and the display name in Benchling. Currently, both fields always have an identical value corresponding to the originally uploaded file’s name.

Going forward, these fields will be be populated properly with distinct values:

* The `name` field will include the display name of the file used in Benchling. `name` can be updated in Benchling or via the API.
* The `filename` field will include the filename of the original file uploaded to Benchling. `filename` cannot be changed in Benchling or via the API.

When creating files in Benchling via the API, both `name` and `filename` will be required. Additionally, updating files in Benchling via the API will optionally accept `name`, which will update the file’s display name.

### When is this happening?

This change will go live on **February 8th 2024**.