/api/v1/fingerbank/{scope}/mac_vendors:
  get:
    summary: Get MAC Vendors.
    parameters:
    - name: scope
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/FingerbankScope'
    - name: cursor
      in: query
      schema:
        $ref: '#/components/schemas/FingerbankPaginatedCursor'
    - name: limit
      in: query
      schema:
        $ref: '#/components/schemas/FingerbankPaginatedLimit'
    - name: sort
      in: query
      schema:
        $ref: '#/components/schemas/FingerbankMacVendorsSort'
    responses:
      '200':
        $ref: '#/components/responses/FingerbankMacVendors'
      '401':
        $ref: '#/components/responses/Unauthorized'
    tags:
      - Fingerbank
  post:
    summary: Create local MAC Vendor.
    parameters:
    - name: scope
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/FingerbankScopeLocalOnly'
    requestBody:
      $ref: '#/components/requestBodies/FingerbankMacVendor'
    responses:
      '200':
        $ref: '#/components/responses/Created'
      '401':
        $ref: '#/components/responses/Unauthorized'
    tags:
      - Fingerbank

/api/v1/fingerbank/{scope}/mac_vendors/search:
  parameters:
  - name: scope
    in: path
    required: true
    schema:
      $ref: '#/components/schemas/FingerbankScope'
  post:
    summary: Search local MAC Vendors.
    requestBody:
      $ref: '#/components/requestBodies/FingerbankMacVendorsSearch'
    responses:
      '200':
        $ref: '#/components/responses/FingerbankMacVendorsSearch'
      '401':
        $ref: '#/components/responses/Unauthorized'
    tags:
      - Fingerbank

/api/v1/fingerbank/{scope}/mac_vendor/{mac_vendor_id}:
  parameters:
  - name: scope
    in: path
    required: true
    schema:
      $ref: '#/components/schemas/FingerbankScopeLocalOnly'
  - name: mac_vendor_id
    in: path
    required: true
    schema:
      type: string
  get:
    summary: Get local MAC Vendor.
    responses:
      '200':
        $ref: '#/components/responses/FingerbankMacVendor'
      '401':
        $ref: '#/components/responses/Unauthorized'
      '404':
        $ref: '#/components/responses/NotFound'
    tags:
      - Fingerbank
  patch:
    summary: Update local MAC Vendor.
    requestBody:
      $ref: '#/components/requestBodies/FingerbankMacVendor'
    responses:
      '200':
        $ref: '#/components/responses/Updated'
      '401':
        $ref: '#/components/responses/Unauthorized'
      '404':
        $ref: '#/components/responses/NotFound'
    tags:
      - Fingerbank
  delete:
    summary: Delete local MAC Vendor.
    responses:
      '200':
        $ref: '#/components/responses/Deleted'
      '401':
        $ref: '#/components/responses/Unauthorized'
      '404':
        $ref: '#/components/responses/NotFound'
    tags:
      - Fingerbank
