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

# Play Recording

> Play a recorded episode.



## OpenAPI

````yaml post /recording/play
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security: []
paths:
  /recording/play:
    post:
      tags:
        - recording
      summary: Play Recording
      description: Play a recorded episode.
      operationId: play_recording_recording_play_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecordingPlayRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    RecordingPlayRequest:
      description: Request to play a recorded episode.
      examples:
        - dataset_name: example_dataset
          episode_id: 0
        - episode_path: >-
            ~/phosphobot/lerobot_v2/example_dataset/chunk-000/episode_000000.json
          replicate: false
          robot_id:
            - 0
            - 1
      properties:
        dataset_format:
          default: lerobot_v2.1
          description: >-
            Format of the dataset to play. This is used to determine how to read
            the episode data.
          enum:
            - lerobot_v2
            - lerobot_v2.1
          title: Dataset Format
          type: string
        dataset_name:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Name of the dataset to play the episode from. If None, defaults to
            the last dataset recorded.
          examples:
            - example_dataset
          title: Dataset Name
        episode_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            ID of the episode to play. If a dataset_name is specified but
            episode_id is None, plays the last episode recorded of this dataset.
            If dataset_name is None, this is ignored and plays the last episode
            recorded.
          examples:
            - 0
          title: Episode Id
        episode_path:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            (Optional) If you recorded your data with LeRobot v2 compatible
            format, you can directly specifiy the path to the .parquet file of
            the episode to play. If specified, you don't have to pass a
            dataset_name or episode_id.
          examples:
            - >-
              ~/phosphobot/lerobot_v2/example_dataset/chunk-000/episode_000000.json
          title: Episode Path
        interpolation_factor:
          default: 4
          description: >-
            Smoothen the playback by interpolating between frames. 1 means no
            interpolation, 2 means 1 frame every 2 frames, etc. 4 is the
            recommended value.
          minimum: 1
          title: Interpolation Factor
          type: integer
        playback_speed:
          default: 1
          description: >-
            Speed of the playback. 1.0 is normal speed, 0.5 is half speed, 2.0
            is double speed. High speed may cause the robot to break.
          minimum: 0
          title: Playback Speed
          type: number
        replicate:
          default: true
          description: >-
            If False and there are more robots than number of robots in the
            episode, extra robots will not move. If True, all the extras robots
            will replicate movements of the robots in the episode.Examples: If
            there are 4 robots and the episode has 2 robots, if replicate is
            True, robot 3 and 4 will replicate the movements of robot 1 and 2.
            If replicate is False, robot 3 and 4 will not move.
          title: Replicate
          type: boolean
        robot_id:
          anyOf:
            - type: integer
            - items:
                type: integer
              type: array
            - type: 'null'
          description: >-
            ID of the robot to play the episode on. If None, plays on all
            robots. If a list, plays on the robots with the given IDs.
          examples:
            - 0
            - - 0
              - 1
          title: Robot Id
        robot_serials_to_ignore:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: >-
            List of robot serial ids to ignore. If set to None, plays on all
            available robots.
          examples:
            - - /dev/ttyUSB0
          title: Robot Serials To Ignore
      title: RecordingPlayRequest
      type: object
    StatusResponse:
      additionalProperties: true
      description: Default response. May contain other fields.
      properties:
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
        status:
          default: ok
          enum:
            - ok
            - error
          title: Status
          type: string
      title: StatusResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````