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

# List Canvas Items

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

Lists the items in the replica's Canvas (files agents drop into `~/.replicas/canvas/`). Each item has a `kind` (markdown, html, image, video, audio, or other) inferred from its extension and a `sizeBytes` measured at list time. Files larger than 5 MB are still listed; the `getReplicaCanvasItem` endpoint will return `tooLarge: true` for them so callers know to fall back to `replicas media upload`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful response

- CanvasListResponse — List of items the agent has dropped into the Canvas.
  - `items` CanvasItem[], required
    - `filename` string, required — The basename of the file inside the Canvas directory.
    - `kind` 'markdown' | 'html' | 'image' | 'video' | 'audio' | 'other', required — The kind of Canvas item, inferred from its file extension.
    - `sizeBytes` 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
- `502` — Bad gateway - The workspace is unreachable or returned an invalid response

---

[API](https://skmtc.net/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.net/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/versions/aa3b4c932f7a/schema)