Skip to main content
GET
List Episodes

Query Parameters

policy_version_id
string<uuid> | null
tags
string | null

Comma-separated key:value filters

limit
integer
default:50
Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

id
string<uuid>
required

Unique episode identifier

replay_url
string | null
required

URL to the episode replay recording

thumbnail_url
string | null
required

URL to a thumbnail image of the episode

tags
Tags · object
required

Key-value tags attached to this episode. Common keys: game (game name, e.g. 'cogsguard'), match_type (e.g. 'self_play', 'pairing'), job_id, scheduler_git_ref.

game_stats
Game Stats · object
required

Game-level aggregate statistics. Keys include object counts (objects., e.g. objects.junction, objects.wall, objects.agent.agent, objects.hub, objects.chest, objects._extractor, objects._station) and observation token stats (tokens_written, tokens_dropped, tokens_free_space).

Example:
policy_results
PolicyResult · object[]
required

Results broken down by policy

steps
integer | null
required

Number of environment steps in the episode

created_at
string<date-time>
required

When the episode was recorded