---
title: "List Canvas files"
method: GET
path: "/v1/replica/{id}/canvas"
tags: ["Canvas"]
---

# List Canvas files

`GET /v1/replica/{id}/canvas`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/replica/{id}/canvas`
- Auth: HTTP bearer

Lists plans, reports, and other files the agent put in the [Canvas](/features/workspaces/canvas).

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Replicas-Api-Version` '2026-10-07'

## Response `200`

Success

- CanvasListResponse: List of items the agent has dropped into the Canvas.
  - `items` CanvasItem[], required
    - `filename` string, required: The Canvas-relative file path, including nested folders.
    - `kind` 'markdown' | 'mermaid' | 'html' | 'text' | 'image' | 'pdf' | 'docx' | 'video' | 'audio' | 'other', required: The kind of Canvas item, inferred from its file extension.
    - `size_bytes` integer, required: File size in bytes, measured at list time.

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `404`: Resource not found
- `500`: Internal server error

---

[API](https://skmtc.dev/replicas/apis/replicas-api.md) - [All operations](https://skmtc.dev/replicas/apis/replicas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/replicas/apis/replicas-api/revisions/2703ac1c9cb7?raw)