---
title: "Browse project canvases, newest activity first"
method: GET
path: "/v1/admin/canvases"
tags: ["Admin Canvases"]
---

# Browse project canvases, newest activity first

`GET /v1/admin/canvases`

## Query parameters

- `cursor` string
- `limit` integer
- `q` string

## Response `200`

Admin canvases retrieved

- AdminCanvasesApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object[], required — Array of data items
    - `canvasId` string, uuid, required
    - `projectId` string, uuid, required
    - `projectName` string, nullable, required
    - `projectIsDeleted` boolean, required
    - `ownerUserId` string, uuid, nullable, required
    - `ownerEmail` string, nullable, required
    - `ownerIsDeleted` boolean, required
    - `companyName` string, nullable, required
    - `revision` integer, required
    - `updatedAt` string, date-time, required
    - `elementCount` integer, required
    - `imageCount` integer, required
    - `planCount` integer, required
    - `uploads` object[], required
      - `assetId` string, uuid, required
      - `name` string, required
      - `imageUrl` string, nullable, required
      - `fullImageUrl` string, nullable, required
      - `isDeleted` boolean, required
    - `elements` union[], required
      - union
        - object
          - `x` number, required
          - `y` number, required
          - `w` number, required
          - `h` number, required
          - `assetId` string, uuid, required
          - `rotation` number
          - `z` integer, required
          - `type` 'image', required
          - `imageUrl` string, nullable, required
          - `fullImageUrl` string, nullable, required
          - `imageAssetId` string, uuid, nullable, required
          - `isFallbackImage` boolean, required
          - `imageStatus` 'available' | 'soft_deleted' | 'missing', required
          - `prompt` string, nullable, required
          - `generation` union, required
            - object
              - …
            - object
              - …
            - object
              - …
        - object
          - `x` number, required
          - `y` number, required
          - `w` number, required
          - `h` number, required
          - `assetId` string, uuid, required
          - `rotation` number
          - `z` integer, required
          - `type` 'floorplan', required
          - `level` integer, required
  - `meta` object, required
    - `hasNext` boolean, required — Whether there are more items after current set
    - `hasPrevious` boolean, required — Whether there are items before current set
    - `nextCursor` string, nullable, required — Cursor for next page
    - `prevCursor` string, nullable, required — Cursor for previous page
    - `totalCount` integer, required
  - `timestamp` string, date-time, required — Timestamp of the response

## Changes

- **2026-09-22** `440fd2e839fa` — 3 warning, 2 info
  - deleted the `query` request parameter `includeEmpty`
  - deleted the `query` request parameter `ownerUserId`
  - deleted the `query` request parameter `projectId`
  - added the new optional `query` request parameter `q`
  - …1 more
- **2026-09-19** `28c2b3b6b3b4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maket/apis/virtual-architect-api/changes/v1/admin/canvases/get.md)

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maket/apis/virtual-architect-api/revisions/ad71cae36f29?raw)