---
title: "Query Snapshots"
method: POST
path: "/projects/{project_id}/playgrounds/{playground_id}/snapshots/query"
tags: ["playground_snapshots"]
---

# Query Snapshots

`POST /projects/{project_id}/playgrounds/{playground_id}/snapshots/query`

List a playground's snapshots.

Args:
    ctx: Async request context supplying the read session and current user.
    playground: Playground resolved from the URL, verified to belong to the URL project.
    pagination: Page window to read.
    params: Sort to apply.

Returns:
    The requested page of snapshots.

## Path parameters

- `project_id` string, uuid4, required
- `playground_id` string, uuid4, required

## Query parameters

- `starting_token` integer
- `limit` integer

## Request body

- ListPlaygroundSnapshotsParams
  - `sort` PlaygroundSnapshotCreatedAtSort
    - `name` 'created_at'
    - `ascending` boolean
    - `sort_type` 'column'

## Response `200`

Successful Response

- ListPlaygroundSnapshotsResponse
  - `starting_token` integer
  - `limit` integer
  - `paginated` boolean
  - `next_starting_token` integer, nullable
  - `snapshots` PlaygroundSnapshotResponse[], required
    - `id` string, uuid4, required
    - `created_at` string, date-time, required
    - `experiment_id` string, uuid4, required
    - `created_by_user` UserInfo, required — A user's basic information, used for display purposes.
      - `id` string, uuid4, required
      - `email` string, required
      - `first_name` string, nullable
      - `last_name` string, nullable
    - `num_rows` integer, required
    - `scorers` PlaygroundSnapshotScorer[], required
      - `id` string, uuid4, required
      - `name` string, nullable
    - `dataset` PlaygroundSnapshotDataset, required
      - `id` string, uuid4, required
      - `name` string, required
      - `version_index` integer, required

## Other responses

- `422` — Validation Error

## Changes

> 24 revisions in range; 2 not diffed.

- **2026-08-05** `1f7a6a4a81ad` — 1 breaking
  - the response property `snapshots/items/scorers/items/name` became optional for the status `200`
- **2026-07-26** `05003e7835a2` — 1 info
  - the endpoint scheme security `ClassicAPIKeyHeader` was added to the API

[Change history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/projects/:project_id/playgrounds/:playground_id/snapshots/query/post.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api-server/revisions/fede84842199?raw)