The Canva Apps SDK, Connect APIs, and MCP are now unified in the Canva Developers SDK. Learn more⁠(opens in a new tab or window).
Canva Developers SDK
The Canva Apps SDK, Connect APIs, and MCP are now unified in the Canva Developers SDK. Learn more⁠(opens in a new tab or window).

get-separate-image-layers-job

Check the status of a layer separation job and get the new design.

Use get-separate-image-layers-job to poll a job started by separate-image-layers.

Example prompt

"Is my editable poster ready?"

Pass the job_id and the continuation_token from the most recent separate-image-layers or get-separate-image-layers-job response.

Example response

IDs, URLs, and tokens below are placeholders; field names and structure are exactly as returned.

{
"job_id": "job_EXAMPLE",
"status": "completed",
"design": {
"id": "DAF_EXAMPLE",
"url": "https://www.canva.com/d/EXAMPLE",
"edit_url": "https://www.canva.com/d/EXAMPLE"
}
}
JSON

A status of completed returns the new design with its id and edit link. Give the user the link.

While the job runs, the status is in_progress and the response contains a new continuation_token and a polling_policy. Wait for polling_policy.wait_seconds, then poll again with the same job_id and the new token. Polling sooner returns a status of polled_too_early. If the job fails, the status is failed and the response contains a failure with a code and message.

Learn more