openapi: 3.2.0
info:
  description: API for Review Mode
  version: 1.0.0
  title: Review Slides API
servers:
- url: /review
tags:
- name: slides
paths:
  /api/v1/review/users/{userId}/skills/{skillRef}/slide:
    get:
      tags:
      - slides
      summary: Get slide available to be reviewed for the given user and skill.
      description: Get slide available to be reviewed for the given user and skill.
      operationId: getSlideToReview
      security:
      - token: []
      parameters:
      - name: userId
        in: path
        required: true
        schema:
          type: string
        description: User identifier
        example: 5931704711aa953900e32d43
      - name: skillRef
        in: path
        required: true
        schema:
          type: string
        description: Skill ref
        example: skill_E1mUIKFir
      - name: limit
        in: query
        required: true
        schema:
          type: number
        description: limit, default is 1
        example: '2'
      - name: offset
        in: query
        required: true
        schema:
          type: number
        description: offset, default is 0
        example: '0'
      responses:
        '200':
          description: Available slide ref
          content:
            application/json:
              schema:
                type: string
                example: sli_41ite5TXc
components:
  securitySchemes:
    token:
      type: apiKey
      name: authorization
      in: header