Skip to main content
GET
List canvases owned by the caller

Authorizations

Authorization
string
header
required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Query Parameters

agent_id
string
Maximum string length: 64
conversation_id
string
Maximum string length: 64
artifact_type
string

One artifact type, or several separated by commas (e.g. code,slides). tool_result is ignored.

Maximum string length: 256

Case-insensitive search on the title, matched as literal text.

Maximum string length: 200
sort
enum<string>

Sort order, most recently edited (content or title; detaching a canvas from a deleted conversation is not an edit), most recently created (default), or title A→Z.

Available options:
updated,
created,
title
limit
string

Page size (default 50, max 100).

page
string

1-based page number (default 1).

Response

Page of canvases.

Paginated list of canvases. total and has_more are computed on the same query as the page.

artifacts
object[]
page
integer
limit
integer
total
integer

Number of canvases matching the filters, all pages included.

has_more
boolean