---
title: "Get Aperture Live Dataset"
method: POST
path: "/api/v1/aperture/datasets/live"
tags: ["aperture"]
---

# Get Aperture Live Dataset

`POST /api/v1/aperture/datasets/live`

## Request body

- ApertureLiveDatasetRequest — A POST body because the viewer refreshes every episode it shows, which outgrows a URL.
  - `dataset_name` string, required
  - `split` string
  - `limit` integer
  - `offset` integer
  - `refresh_tid` string[]
  - `before_tid` string, nullable
  - `dataset_source` 'default'

## Response `200`

Successful Response

- ApertureLiveDatasetResponse
  - `trajectories` ApertureLiveDatasetTrajectory[], required
    - `xid` string, required
    - `trajectory_id` string, nullable
    - `trajectory_idx` integer, required
    - `status` string, nullable
    - `reward` number, nullable
    - `task` string, nullable
    - `task_gcs_uri` string, nullable
    - `step_uris` string[], required
    - `reference_step_uris` string[]
    - `reference_trajectory_json` string, nullable
    - `metrics` union
      - string
      - object
    - `execution_metrics` union
      - string
      - object
    - `trajectory_json` string, nullable
    - `trajectory_json_gcs_uri` string, nullable
    - `telemetry_data` union
      - string
      - object
    - `reward_components` union
      - string
      - unknown[]
        - unknown
    - `error` string, nullable
    - `created_at` union
      - string
      - string, date-time
    - `updated_at` union
      - string
      - string, date-time
    - `uid` string, nullable
    - `mode` string, nullable
    - `global_step` integer, nullable
    - `storage_source` string, nullable
    - `blob_source` string, nullable
    - `training_step` integer, nullable
    - `has_reference` boolean, nullable
    - `trajectory_blob_token` string, nullable
    - `parsed` ApertureXidParsedTrajectory, required
      - `task` ApertureXidTask
        - `id` unknown
        - `task_id` unknown
        - `instruction` unknown
        - `question` unknown
        - `title` unknown
        - `type` unknown
      - `steps` ApertureXidStep[], required
        - `messages` ApertureXidMessage[], required
          - `role` string, required
          - `content` union
            - string
            - object[]
              - …
          - `reasoning` string, nullable
          - `tool_calls` object[], nullable
          - `tool_response` object, nullable
          - `usage` object, nullable
          - `metadata` object, nullable
          - `started_at_us` number, nullable
          - `duration_seconds` number, nullable
          - `token_count` integer, nullable
          - `preview_truncated` boolean, nullable
          - `message_blob_token` string, nullable
        - `reward` object, nullable
        - `info` object, nullable
        - `raw_input` string, nullable
        - `raw_output` string, nullable
        - `tokens` integer[], nullable
        - `token_masks` integer[], nullable
        - `logprobs` number[], nullable
        - `train_logprobs` number[], nullable
        - `token_strings` string[], nullable
        - `advantages` number[], nullable
        - `trainable_status` string, nullable
        - `deferred_fields` string[], nullable
      - `step_count` integer, required
      - `total_reward` number, nullable
      - `reward` object, nullable
      - `metrics` object, nullable
      - `execution_metrics` object, nullable
      - `telemetry` object, nullable
    - `source` 'dataset', required
    - `dataset_name` string, required
    - `dataset_split` string, required
    - `organization_id` string, required
    - `dataset_source` 'default', required
    - `episode` ApertureDatasetEpisode, required
      - `capture` string, required
      - `termination_reason` string, nullable, required
      - `reward_state` 'valid' | 'unknown' | 'failed', required
      - `reward_version` string, nullable, required
      - `ready` boolean, required
      - `failed` boolean, required
      - `training` 'unassigned' | 'snapshot' | 'prepared' | 'trained', required
      - `behavior_endpoint` string, nullable, required
      - `behavior_checkpoint` string, nullable, required
      - `behavior_checkpoint_step` integer, nullable, required
      - `frozen_rewards` ApertureFrozenReward[], required
        - `snapshot_id` string, required
        - `score_id` string, required
        - `value` number, nullable, required
      - `updates` ApertureDatasetUpdate[], required
        - `snapshot_id` string, required
        - `xid` string, nullable, required
        - `step` integer, nullable, required
        - `status` string, required
        - `checkpoint_id` string, nullable, required
        - `checkpoint_step` integer, nullable, required
        - `global_step` integer, nullable
        - `checkpoint_path` string, nullable, required
        - `trajectory_ids` string[], required
  - `counts` ApertureDatasetCounts, required
    - `admitted` integer, required
    - `active` integer, required
    - `awaiting_reward` integer, required
    - `ready` integer, required
    - `failed` integer, required
    - `trained` integer, required
  - `updates` ApertureDatasetUpdate[], required
    - `snapshot_id` string, required
    - `xid` string, nullable, required
    - `step` integer, nullable, required
    - `status` string, required
    - `checkpoint_id` string, nullable, required
    - `checkpoint_step` integer, nullable, required
    - `global_step` integer, nullable
    - `checkpoint_path` string, nullable, required
    - `trajectory_ids` string[], required
  - `has_more` boolean, required
  - `next_offset` integer, required
  - `organization_id` string, required
  - `training_available` boolean, required

## Changes

- **2026-09-24** `4087cc7a74aa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trajectory/apis/trajectory-api/changes/api/v1/aperture/datasets/live/post.md)

---

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