List the groups of one step of a fine-tuning job
Available only to organizations enabled for fine-tuning; any other organization receives 400 invalid_request on every fine-tuning operation. Returns the groups of one split and step, each the attempts sampled for one task (a GRPO group) with the mean and standard deviation of their rewards, filtered, searched by task name, sorted and paged server-side. total counts every matching group. Both reads of a request run at one snapshot of the step, so every item matches the filter and order that selected it. Each request takes its own snapshot: read the same page again with the same parameters and cursor to follow a running step (a cursor expires one hour after it is issued). Paging through a step that is still changing can skip or repeat groups; a walk through the pages is complete only once the step has no queued or running attempts.
Authorizations
Headers
Query Parameters
What to order the groups by; the group index by default. task compares the raw task name byte by byte, so it is case-sensitive, unlike q. Groups without a score sort last for meanReward and stdReward in either direction, and ties fall back to ascending group index. Any other value is rejected with 400.
group, task, meanReward, stdReward Maximum groups to return. A page carries limit groups with all their attempts (up to 16 each), so on a 16-attempt held-out step a limit above about 100 can exceed 1 MiB; clients that cap a response at that size, such as MCP tool results, should page with a smaller limit.
1 <= x <= 200Response
OK
Opaque continuation cursor, or null on the last page. It holds an offset into an order computed from the step's current rollouts on every read, so while the step runs a walk through the pages can skip or repeat groups (as scores, statuses or new attempts move them between pages).