get:
  tags:
    - Contact
  operationId: contactDetails
  summary: Show Contact
  parameters:
    - name: id
      in: path
      type: number
      description: id of the contact
      required: true
  responses:
    200:
      description: Success
      schema:
        $ref: '#/definitions/extended_contact'
    404:
      description: Contact not found
    403:
      description: Access denied

put:
  tags:
    - Contact
  operationId: contactUpdate
  summary: Update Contact
  parameters:
    - name: id
      in: path
      type: number
      description: id of the contact
      required: true
    - name: data
      in: body
      required: true
      schema:
        $ref: '#/definitions/contact_update'
  responses:
    204:
      description: Success
      schema:
        $ref: '#/definitions/contact_base'
    404:
      description: Contact not found
    403:
      description: Access denied