swagger: "2.0"
host: api.example.com
schemes:
  - https
info:
  title: An Example API Spec
  version: "1"

paths:
  /users/{user_id}/:
    get:
      operationId: getUser
      summary: Get user details
      parameters:
        - $ref: '#/parameters/userIdUrlParam'
      responses:
        "200":
          description: Success
    patch:
      operationId: updateUser
      summary: Update user details
      parameters:
        - $ref: '#/parameters/userIdUrlParam'
      responses:
        "204":
          description: Success
    delete:
      operationId: deleteUser
      summary: Delete a user
      parameters:
        - $ref: '#/parameters/userIdUrlParam'
      responses:
        "204":
          description: Success

parameters:
  userIdUrlParam:
    name: user_id
    in: path
    description: User ID
    required: true
    type: string