---
title: "List Canvas Interactions"
method: GET
path: "/v2/conversations/{conversation_id}/canvas/interactions"
tags: ["Conversations"]
---

# List Canvas Interactions

`GET /v2/conversations/{conversation_id}/canvas/interactions`

Returns every Canvas interaction recorded for a conversation, oldest first. Uses the same field shape as the `canvas.interaction` webhook's `properties` object.

Readable during and after the conversation. Call from your backend with your API key - not from the browser.

See [Canvas interactions](/sections/conversational-video-interface/magic-canvas/api/interactions).

## Response `200`

Interaction history returned

- object
  - `data` CanvasInteractionRecord[]
    - `conversation_id` string
    - `interaction_id` string
    - `tool_call_id` string — The Canvas invocation that showed the card.
    - `component` string
    - `component_version` string
    - `type` string
    - `value` object
    - `metadata` object
    - `created_at` string, nullable — When the interaction was recorded. Naive ISO-8601 with microseconds and no timezone suffix (UTC).

## Other responses

- `400` — Bad Request
- `401` — UNAUTHORIZED

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)