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

# List model resources

> Lists the caller's model resources.



## OpenAPI

````yaml openapi.yaml GET /rl/model-resources
openapi: 3.1.0
info:
  title: Together APIs
  description: The Together REST API. See https://docs.together.ai for more details.
  version: 2.0.0
  termsOfService: https://www.together.ai/terms-of-service
  contact:
    name: Together Support
    url: https://www.together.ai/contact
  license:
    name: MIT
    url: https://github.com/togethercomputer/openapi/blob/main/LICENSE
servers:
  - url: https://api.together.ai/v1
    description: Default environment for APIs
  - url: https://api-inference.together.ai/v2
    description: Optimized environment for inference
security:
  - bearerAuth: []
paths:
  /rl/model-resources:
    get:
      tags:
        - RL
      summary: List model resources
      description: Lists the caller's model resources.
      operationId: listModelResources
      parameters:
        - name: status
          in: query
          required: false
          schema:
            description: >-
              Status filters. When omitted, resources in any status are
              returned.
            type: array
            items:
              type: string
              enum:
                - MODEL_RESOURCES_STATUS_PENDING
                - MODEL_RESOURCES_STATUS_CREATING
                - MODEL_RESOURCES_STATUS_READY
                - MODEL_RESOURCES_STATUS_ERROR
                - MODEL_RESOURCES_STATUS_STOPPED
                - MODEL_RESOURCES_STATUS_STOPPING
        - name: limit
          in: query
          required: false
          schema:
            description: Maximum number of resources to return (1-100)
            type: integer
            default: 20
        - name: after
          in: query
          required: false
          schema:
            description: Cursor for pagination
            type: string
        - name: created_by
          in: query
          required: false
          schema:
            description: >-
              Filter resources in the current project by the creator ID. Pass
              "me" to show resources you created.
            type: string
      responses:
        '200':
          description: List of model resources
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RL.ModelResourcesListResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorData'
components:
  schemas:
    RL.ModelResourcesListResponse:
      type: object
      description: Paginated list of model resources
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/RL.ModelResources'
          description: List of model resources
        meta:
          $ref: '#/components/schemas/RL.ListMeta'
          description: Pagination metadata
    ErrorData:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              nullable: false
            type:
              type: string
              nullable: false
            param:
              type: string
              nullable: true
              default: null
            code:
              type: string
              nullable: true
              default: null
          required:
            - type
            - message
    RL.ModelResources:
      type: object
      description: Allocated GPU resources that training sessions attach to
      required:
        - id
        - status
        - base_model
        - compute_config
        - lora_enabled
        - created_at
        - updated_at
        - optimizer_config
        - created_by
      properties:
        id:
          type: string
          example: 123e4567-e89b-12d3-a456-426614174000
          description: Unique identifier for the model resource
        status:
          $ref: '#/components/schemas/RL.ModelResourcesStatus'
          example: MODEL_RESOURCES_STATUS_READY
          description: Lifecycle status of the model resource
        error:
          $ref: '#/components/schemas/RL.ModelResourcesError'
          description: >-
            Structured detail for the model resource's current error. Set when
            the resource is in an error state.
        base_model:
          type: string
          example: Qwen/Qwen3.5-4B
          description: Base model the resource is provisioned for
        base_weights_ref:
          type: string
          example: together://ml_A1b2C3d4E5f6G7h8I9j0K@rv_A1b2C3d4E5f6G7h8I9j0K
          description: >-
            Model-registry model whose weights the resource trains in place of
            the base model's own, pinned to the revision resolved when the
            resource was created. Absent when the resource trains the base
            model's own weights.
        compute_config:
          $ref: '#/components/schemas/RL.ComputeConfig'
          description: Compute layout provisioned for the resource.
        lora_enabled:
          type: boolean
          example: true
          description: Whether the resource hosts LoRA sessions or a full-weight session
        created_at:
          type: string
          format: date-time
          example: '2026-01-02T00:00:00Z'
          description: Timestamp when the model resource was created
        updated_at:
          type: string
          format: date-time
          example: '2026-01-02T00:00:05Z'
          description: Timestamp when the model resource was last updated
        optimizer_config:
          $ref: '#/components/schemas/RL.OptimizerConfig'
          description: Optimizer configuration for this resource.
        created_by:
          type: string
          example: user_123
          description: ID of the user who created the model resource
    RL.ListMeta:
      type: object
      description: Pagination metadata for list responses
      properties:
        limit:
          type: integer
          example: 20
          description: Maximum number of items returned per page
        has_more:
          type: boolean
          example: true
          description: Whether more items exist beyond this page
        next_cursor:
          type: string
          example: 123e4567-e89b-12d3-a456-426614174000
          description: >-
            Cursor to use as the 'after' parameter for the next page. Empty when
            has_more is false.
    RL.ModelResourcesStatus:
      description: Lifecycle status of a model resource
      type: string
      enum:
        - MODEL_RESOURCES_STATUS_PENDING
        - MODEL_RESOURCES_STATUS_CREATING
        - MODEL_RESOURCES_STATUS_READY
        - MODEL_RESOURCES_STATUS_ERROR
        - MODEL_RESOURCES_STATUS_STOPPED
        - MODEL_RESOURCES_STATUS_STOPPING
    RL.ModelResourcesError:
      type: object
      description: Structured detail for the model resource's current error
      required:
        - code
        - message
        - occurred_at
      properties:
        code:
          $ref: '#/components/schemas/RL.ModelResourcesErrorCode'
          example: MODEL_RESOURCES_ERROR_CODE_CAPACITY_WAIT_TIMEOUT
          description: Finite machine-readable reason code for UI branching
        message:
          type: string
          example: Timed out waiting for cluster capacity. Try again later.
          description: User-safe human-readable detail for the current status
        occurred_at:
          type: string
          format: date-time
          example: '2026-01-02T00:00:05Z'
          description: Timestamp when this error was reported
    RL.ComputeConfig:
      type: object
      description: Compute layout for a model resource
      required:
        - num_generator_replicas
      properties:
        num_generator_replicas:
          type: integer
          format: int32
          example: 1
          description: >-
            Number of generator replicas. 0 means the resource runs the trainer
            only, with no generator.
        gpu_type:
          type: string
          example: H100-80GB
          enum:
            - H100-80GB
            - B200-SXM
          description: GPU type selected for this resource.
    RL.OptimizerConfig:
      type: object
      description: Optimizer configuration
      properties:
        adam:
          $ref: '#/components/schemas/RL.AdamConfig'
          description: Use the Adam optimizer.
        muon:
          $ref: '#/components/schemas/RL.MuonConfig'
          description: Use the Muon optimizer.
    RL.ModelResourcesErrorCode:
      type: string
      description: Finite machine-readable model resource lifecycle error code
      enum:
        - MODEL_RESOURCES_ERROR_CODE_CAPACITY_WAIT_TIMEOUT
        - MODEL_RESOURCES_ERROR_CODE_PROVISIONING_FAILED
        - MODEL_RESOURCES_ERROR_CODE_RESOURCE_UNAVAILABLE
    RL.AdamConfig:
      type: object
      description: Adam optimizer configuration
      properties: {}
      additionalProperties: false
      x-stainless-empty-object: true
    RL.MuonConfig:
      type: object
      description: Advanced configuration for the Muon optimizer.
      properties:
        scaling_strategy:
          $ref: '#/components/schemas/RL.MuonScalingStrategy'
          example: MUON_SCALING_STRATEGY_ORIGINAL
          default: MUON_SCALING_STRATEGY_MATCH_ADAM
          description: Scaling strategy for the Muon optimizer.
    RL.MuonScalingStrategy:
      type: string
      enum:
        - MUON_SCALING_STRATEGY_UNSPECIFIED
        - MUON_SCALING_STRATEGY_MATCH_ADAM
        - MUON_SCALING_STRATEGY_ORIGINAL
      default: MUON_SCALING_STRATEGY_UNSPECIFIED
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      x-bearer-format: bearer
      x-default: default

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.