swagger: '2.0'
info:
  description: "Administrate tokens"
  version: latest-SNAPSHOT
  title: Token API

basePath: /api/oath

paths:
  /tokens:
    post:
      summary: Import PSKC file
      operationId: importPskcFile
      description: |
        Import PSKC file
      consumes:
        - multipart/form-data
      produces:
        - text/plain
      parameters:
        - in: formData
          name: file
          description: PSKC file to import
          type: binary
          required: true
      responses:
        201:
          description: Success
        400:
          description: Bad input
        401:
          description: Unauthorized
        404:
          description: Token not found
  /tokens/{orderId}/state:
    put:
      summary: Deactivate a hardware token
      operationId: deactivateHwToken
      description: |
        Deactivate a hardware token
      parameters:
        - in: path
          name: serialNumber
          description: Hardware token serial number
          required: true
          type: string
      responses:
        200:
          description: Token is deactivated
        400:
          description: Bad input
        401:
          description: Unauthorized
        404:
          description: Token not found