---
title: "List stored render metadata for the organization (native app, admin)."
method: GET
path: "/v1/orgs/{orgId}/renders"
tags: ["renders"]
---

# List stored render metadata for the organization (native app, admin).

`GET /v1/orgs/{orgId}/renders`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/v1/orgs/{orgId}/renders`
- Auth: one of:
  - API key in cookie `dvt_session`
  - HTTP bearer

Native app only (DVT-4925): **404 unless the render app-stage is configured**. Admin only
(`render:delete`; **403** otherwise). Metadata only, newest first, keyset-paginated: no URL,
storage key, error text or panel id is ever returned. Includes soft-deleted thumbnails
(`deletedAt` set), renders under soft-deleted dashboards (`dashboardDeleted`), and renders
requested by departed users (`requesterDeleted`, name shown as `deleted user`).
The response is NOT wrapped in the `{data, meta}` envelope.

## Query parameters

- `dashboard_id` string, uuid
- `requested_by` string, uuid
- `source` 'user' | 'email' | 'email_scheduled' | 'validation' | 'thumbnail'
- `limit` integer
- `cursor` string

## Response `200`

One page of render metadata.

- AdminRenderList
  - `items` AdminRenderMeta[], required
    - `id` string, uuid, required
    - `dashboardId` string, uuid, required
    - `dashboardTitle` string, required
    - `dashboardDeleted` boolean, required: The render's dashboard is soft-deleted.
    - `revision` integer, required
    - `page` integer, required
    - `format` string, required
    - `source` 'user' | 'email' | 'email_scheduled' | 'validation' | 'thumbnail', required
    - `status` string, required
    - `sizeBytes` integer, nullable, required
    - `requestedBy` string, required: The requesting user's id (empty when none).
    - `requesterName` string, required: Display name, or "deleted user" for a departed or scrubbed requester.
    - `requesterDeleted` boolean, required
    - `createdAt` string, date-time, required
    - `deletedAt` string, date-time, nullable, required: Set only on a soft-deleted thumbnail.
  - `nextCursor` string, nullable, required: Present only when the page was full; pass it back as `cursor`.

## Other responses

- `400`: Malformed request.
- `401`: Missing, invalid, or expired session.
- `403`: The caller's role does not permit this action.
- `404`: Resource does not exist.
- `429`: Per-actor API rate limit exceeded (SEC-2). All authenticated `/v1` routes apply a per-actor fixed-window default tier; selected compute-heavy routes (connection tests, column describe, data export) apply an additional tighter tier. Auth endpoints apply a per-IP tier. Problem type: `https://docs.dvt.dev/errors/rate-limited`. Wait for the `Retry-After` response header value (seconds) before retrying.
- `500`: An unexpected internal error occurred.

---

[API](https://skmtc.dev/dvt/apis/dvt-rest-api.md) · [All operations](https://skmtc.dev/dvt/apis/dvt-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dvt/apis/dvt-rest-api/revisions/00016f504165?raw)