> ## Documentation Index
> Fetch the complete documentation index at: https://docs.labelbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml /recursion/openapi.yaml get /managed-agents/v2/fine-tuning-jobs/{jobId}/rollout-groups
openapi: 3.1.0
info:
  title: Managed Agents API
  version: 0.17.0
  description: >-
    The Recursion Managed Agents REST API. Authenticate with a Recursion API key
    as a bearer token. An organization-scoped key acts in its own organization
    and needs nothing else; a tenant-scoped key must also send
    `x-organization-id` with an organization id or `default`. Field names follow
    each operation's published schema.
servers:
  - url: https://api.recursion.labelbox.com
security:
  - bearerAuth: []
paths:
  /managed-agents/v2/fine-tuning-jobs/{jobId}/rollout-groups:
    get:
      tags:
        - Fine-tuning
      summary: List the groups of one step of a fine-tuning job
      description: >-
        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.
      operationId: managedAgentsListFineTuningJobRolloutGroups
      parameters:
        - description: The split to read.
          in: query
          name: split
          required: true
          schema:
            description: The split to read.
            enum:
              - train
              - eval
            type: string
        - description: The step to read.
          in: query
          name: step
          required: true
          schema:
            description: The step to read.
            format: int64
            minimum: 0
            type: integer
            maximum: 9007199254740991
        - description: >-
            Only groups with no queued or running attempt and at least one
            scored attempt: mixed when the scored rewards differ, flat when they
            are all equal (a failed attempt is left out, as in training). Omit
            for every group.
          in: query
          name: spread
          schema:
            description: >-
              Only groups with no queued or running attempt and at least one
              scored attempt: mixed when the scored rewards differ, flat when
              they are all equal (a failed attempt is left out, as in training).
              Omit for every group.
            enum:
              - mixed
              - flat
            type: string
            x-recursion-omission:
              strategy: absent
        - description: >-
            Only groups with at least one attempt in this status. Omit for every
            group.
          in: query
          name: status
          schema:
            description: >-
              Only groups with at least one attempt in this status. Omit for
              every group.
            enum:
              - queued
              - running
              - done
              - failed
            type: string
            x-recursion-omission:
              strategy: absent
        - description: >-
            Only groups whose task name contains this text, ignoring case. Omit
            for every group.
          in: query
          name: q
          schema:
            description: >-
              Only groups whose task name contains this text, ignoring case.
              Omit for every group.
            maxLength: 256
            minLength: 1
            type: string
            x-recursion-omission:
              strategy: absent
        - description: >-
            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.
          in: query
          name: sortBy
          schema:
            default: group
            description: >-
              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.
            enum:
              - group
              - task
              - meanReward
              - stdReward
            type: string
        - description: Direction of sortBy. Any other value is rejected with 400.
          in: query
          name: sortDirection
          schema:
            default: asc
            description: Direction of sortBy. Any other value is rejected with 400.
            enum:
              - asc
              - desc
            type: string
        - description: >-
            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.
          in: query
          name: limit
          schema:
            default: 20
            description: >-
              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.
            maximum: 200
            minimum: 1
            type: integer
        - description: >-
            Opaque cursor from nextCursor. Pass it unchanged with the same
            parameters.
          in: query
          name: cursor
          schema:
            description: >-
              Opaque cursor from nextCursor. Pass it unchanged with the same
              parameters.
            type: string
        - description: Fine-tuning job id.
          in: path
          name: jobId
          required: true
          schema:
            description: Fine-tuning job id.
            format: uuid
            type: string
        - $ref: '#/components/parameters/RecursionTenantId'
        - $ref: '#/components/parameters/RecursionOrganizationId'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FineTuningRolloutGroupListResponse'
          description: OK
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorInvalidRequest'
                x-recursion-error-codes:
                  - invalid_request
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorUnauthorized'
                x-recursion-error-codes:
                  - unauthorized
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '403':
          description: Forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorForbidden'
                x-recursion-error-codes:
                  - forbidden
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '404':
          description: Not Found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorNotFound'
                x-recursion-error-codes:
                  - not_found
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '413':
          description: Payload Too Large.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorPayloadTooLarge'
                x-recursion-error-codes:
                  - payload_too_large
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '429':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
          description: Too Many Requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorRateLimitExceeded'
                x-recursion-error-codes:
                  - rate_limit_exceeded
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorInternalError'
                x-recursion-error-codes:
                  - internal_error
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '502':
          description: A dependent service returned an invalid response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorDependencyFailure'
                x-recursion-error-codes:
                  - bad_gateway
          headers:
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
        '503':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
          description: Service Unavailable.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                  - $ref: >-
                      #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
                discriminator:
                  propertyName: code
                  mapping:
                    managed_agents_unavailable: >-
                      #/components/schemas/ManagedAgentsApiErrorManagedAgentsUnavailable
                    service_unavailable: >-
                      #/components/schemas/ManagedAgentsApiErrorServiceUnavailable
                x-recursion-error-codes:
                  - managed_agents_unavailable
                  - service_unavailable
        '504':
          headers:
            Retry-After:
              description: When to retry, as delay seconds or an HTTP date.
              schema:
                type: string
            recursion-organization-id:
              $ref: '#/components/headers/RecursionOrganizationId'
            recursion-tenant-id:
              $ref: '#/components/headers/RecursionTenantId'
          description: A dependent service timed out.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ManagedAgentsApiErrorDependencyTimeout'
                x-recursion-error-codes:
                  - gateway_timeout
components:
  parameters:
    RecursionTenantId:
      name: x-tenant-id
      in: header
      required: false
      description: >-
        Optional tenant consistency check. When present, it must name the tenant
        bound to the API key, including when x-organization-id is `default`.
      schema:
        minLength: 1
        type: string
    RecursionOrganizationId:
      name: x-organization-id
      in: header
      required: false
      description: >-
        Organization in which to act. Required for a tenant-scoped API key.
        Optional for an organization-scoped key, where it must name that same
        organization. The value may be an organization id or `default`.
      schema:
        minLength: 1
        type: string
  schemas:
    FineTuningRolloutGroupListResponse:
      properties:
        items:
          description: >-
            One page of the step's groups in the requested order; empty when
            none match or when the cursor is past the last match.
          items:
            $ref: '#/components/schemas/FineTuningRolloutGroup'
          type: array
        nextCursor:
          description: >-
            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).
          type:
            - 'null'
            - string
        total:
          description: >-
            Groups matching spread, status and q, across all pages, when this
            page was read.
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
      required:
        - items
        - nextCursor
        - total
      type: object
      additionalProperties: false
    ManagedAgentsApiErrorInvalidRequest:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - invalid_request
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorUnauthorized:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - unauthorized
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorForbidden:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - forbidden
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorNotFound:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - not_found
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorPayloadTooLarge:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - payload_too_large
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorRateLimitExceeded:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - rate_limit_exceeded
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorInternalError:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - internal_error
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorDependencyFailure:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - bad_gateway
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorManagedAgentsUnavailable:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - managed_agents_unavailable
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorServiceUnavailable:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - service_unavailable
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    ManagedAgentsApiErrorDependencyTimeout:
      type: object
      properties:
        code:
          type: string
          minLength: 1
          description: Stable machine-readable error code.
          enum:
            - gateway_timeout
        message:
          type: string
          minLength: 1
          description: Human-readable error message.
        details:
          $ref: '#/components/schemas/ManagedAgentsApiErrorDetails'
          description: >-
            Optional structured error details. Reserved transport fields are
            typed; code-specific fields remain forward compatible.
      required:
        - code
        - message
      additionalProperties: false
      description: Standard flat error response.
    FineTuningRolloutGroup:
      properties:
        attempts:
          description: The group's rollouts by sample.
          items:
            $ref: '#/components/schemas/FineTuningRollout'
          type: array
        counts:
          $ref: '#/components/schemas/FineTuningRolloutCounts'
          description: The group's attempts by status.
        group:
          description: The group within the step.
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        meanReward:
          description: Mean reward of the scored attempts; null before any is scored.
          type:
            - 'null'
            - number
        spread:
          description: >-
            Once no attempt is queued or running and at least one is scored:
            flat when the scored rewards are all equal (a failed attempt is left
            out), so training on the group learns nothing, otherwise mixed; null
            before and when none is scored.
          enum:
            - mixed
            - flat
            - null
          type:
            - 'null'
            - string
        stdReward:
          description: >-
            Standard deviation of the scored attempts' rewards; null before any
            is scored.
          type:
            - 'null'
            - number
        task:
          description: The task every attempt of the group works on.
          type: string
      required:
        - group
        - task
        - attempts
        - counts
        - meanReward
        - stdReward
        - spread
      type: object
      additionalProperties: false
    ManagedAgentsApiErrorDetails:
      type: object
      properties:
        field:
          description: >-
            Request field or header responsible for the error, when one can be
            identified.
          type: string
        issues:
          description: >-
            Boundary-validation failures as path-prefixed human-readable
            messages.
          type: array
          items:
            type: string
        requestId:
          description: Request correlation identifier for support and log lookup.
          type: string
        retryable:
          description: >-
            Server advice about failure transience. `true` means transient,
            `false` means non-transient, and absence gives no advice. Automatic
            replay is allowed only when this field is not `false` and the
            operation-specific retry and idempotency contract permits replay.
          type: boolean
      additionalProperties:
        $ref: '#/components/schemas/PlatformSafeJsonValue'
      description: >-
        Optional structured error details. Reserved transport fields are typed;
        code-specific fields remain forward compatible.
    FineTuningRollout:
      properties:
        error:
          description: Why a failed rollout failed; null otherwise.
          type:
            - 'null'
            - string
        group:
          description: >-
            The group within the step; one task per group. Evaluation rollouts
            use the task's index.
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        pass:
          description: Whether the task's check passed once done; null before.
          type:
            - 'null'
            - boolean
        promptTokens:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        reward:
          description: The task's reward once done; null before.
          type:
            - 'null'
            - number
        rolloutId:
          description: <split>-<step>-<group>-<sample>.
          type: string
        sample:
          description: The sample within the group.
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        sampledTokens:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        split:
          enum:
            - train
            - eval
          type: string
        status:
          enum:
            - queued
            - running
            - done
            - failed
          type: string
        step:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        stopReason:
          description: Why a finished rollout stopped; null before.
          enum:
            - completed
            - context_full
            - turn_limit
            - parse_failure
            - null
          type:
            - 'null'
            - string
        task:
          description: The task the rollout works on.
          type: string
        turns:
          description: Model turns taken so far.
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        updatedAt:
          description: When the rollout last changed.
          format: date-time
          type: string
      required:
        - rolloutId
        - split
        - step
        - group
        - sample
        - task
        - status
        - turns
        - promptTokens
        - sampledTokens
        - reward
        - pass
        - stopReason
        - error
        - updatedAt
      type: object
      additionalProperties: false
    FineTuningRolloutCounts:
      properties:
        done:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        failed:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        queued:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        running:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
        total:
          format: int64
          minimum: 0
          type: integer
          maximum: 9007199254740991
      required:
        - queued
        - running
        - done
        - failed
        - total
      type: object
      additionalProperties: false
    PlatformSafeJsonValue:
      description: >-
        A JSON value whose integer members stay within the exact ECMAScript
        safe-integer range at every nesting level.
      oneOf:
        - type: 'null'
        - type: boolean
        - type: string
        - type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        - type: number
          not:
            type: integer
        - type: array
          items:
            $ref: '#/components/schemas/PlatformSafeJsonValue'
        - additionalProperties:
            $ref: '#/components/schemas/PlatformSafeJsonValue'
          type: object
  headers:
    RecursionOrganizationId:
      description: Organization id resolved for this request.
      schema:
        minLength: 1
        type: string
    RecursionTenantId:
      description: Tenant id resolved for this request.
      schema:
        minLength: 1
        type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A Recursion API key, created in the console under API keys.

````