> 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.

## Adding `app_id` parameter to App Canvas endpoints

The `app_id` parameter will now be returned when querying app canvases, and can optionally be included when creating canvases. The parameter will be required when creating canvases on **June 21st**.

### What’s changing?

We are adding the `app_id` parameter to existing Canvas interfaces in order to explicitly denote which app the Canvas belongs to. This involves two specific changes:

* When making a GET request to a canvas endpoint, the `app_id` property will be included in the response body. This is a non-breaking change, and is currently live.
* When making a POST request to create a canvas, the `app_id` parameter may be provided. Currently, the `app_id` parameter is optional; going forward, the parameter will be required. This is a breaking change that will be implemented on **June 21st**.

### When is this happening?

The `app_id` parameter appearing in canvas payloads and the ability to optionally include it when creating canvases is currently live. The `app_id` parameter will be *required* when creating a canvas starting on **June 21st**.