openapi: 3.1.0
info:
  title: Helpcenter ContactFollowers API
  version: 1.0.0
tags:
- name: ContactFollowers
paths:
  /api/v1/contacts/{contactId}/removeFollowers:
    post:
      tags:
      - ContactFollowers
      summary: Remove contact followers
      description: This API removes one or more users from the followers list of a contact.
      operationId: removeContactFollowers
      parameters:
      - $ref: '#/components/parameters/contactId'
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/removeFollowers'
      responses:
        '422':
          $ref: ./Common.json#/components/responses/multipleUnprocessEntityResponse
        '404':
          $ref: ./errors.json#/components/responses/commonErrorResponse
        '204':
          $ref: ./Common.json#/components/responses/emptyResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.UPDATE
      x-audience:
      - external-public
  /api/v1/contacts/{contactId}/addFollowers:
    post:
      tags:
      - ContactFollowers
      summary: Add contact followers
      description: This API adds one or more users to the followers list of a contact.
      operationId: addContactFollowers
      parameters:
      - $ref: '#/components/parameters/contactId'
      - $ref: ./Common.json#/components/parameters/orgId
      requestBody:
        $ref: '#/components/requestBodies/addFollowers'
      responses:
        '422':
          $ref: ./Common.json#/components/responses/invalidDataErrorResponse
        '404':
          $ref: ./errors.json#/components/responses/commonErrorResponse
        '204':
          $ref: ./Common.json#/components/responses/emptyResponse
      security:
      - iam-oauth2-schema:
        - Desk.contacts.UPDATE
      x-audience:
      - external-public
  /api/v1/contacts/{contactId}/followers:
    get:
      tags:
      - ContactFollowers
      summary: Get contact followers
      description: This API fetches the list of users following a contact.
      operationId: getContactFollowers
      parameters:
      - $ref: '#/components/parameters/contactId'
      - $ref: ./Common.json#/components/parameters/orgId
      responses:
        '200':
          $ref: '#/components/responses/getFollowersResponse'
      security:
      - iam-oauth2-schema:
        - Desk.contacts.READ
      x-audience:
      - external-public
components:
  responses:
    getFollowersResponse:
      description: getFollowersResponse template definitions
      content:
        application/json:
          schema:
            oneOf:
            - type:
              - 'null'
              - object
              additionalProperties: false
              properties:
                data:
                  $ref: ./ContactFollowers.json#/components/schemas/followersDataResponse
              required:
              - data
            - type:
              - 'null'
              - object
              additionalProperties: false
              properties:
                errorCode:
                  type:
                  - string
                  - 'null'
                  enum:
                  - URL_NOT_FOUND
                  - UNAUTHORIZED
                  - INVALID_OAUTH
                  - SCOPE_MISMATCH
                  - FORBIDDEN
                  - LICENSE_ACCESS_LIMITED
                  - METHOD_NOT_ALLOWED
                  - RESOURCE_SIZE_EXCEEDED
                  - UNSUPPORTED_MEDIA_TYPE
                  - INVALID_DATA
                  - UNPROCESSABLE_ENTITY
                  - ONLY_LIVECHAT_USER
                  - INTEGRATION_ADMIN_ERROR
                  - THRESHOLD_EXCEEDED
                  - INTERNAL_SERVER_ERROR
                  - EMPTY_PAYLOAD
                  maxLength: 100
                  minLength: 0
                message:
                  type:
                  - string
                  - 'null'
                  maxLength: 255
                  minLength: 0
              required:
              - errorCode
              - message
          examples:
            Valid responses Definitions:
              value:
                data:
                - firstName: ''
                  lastName: agent
                  photoURL: https://desk.zoho.com/api/v1/agent/5000000012903/photo
                  id: '5000000012903'
                  email: agent@zylker.com
                - firstName: ''
                  lastName: deskagent
                  photoURL: https://desk.zoho.com/api/v1/agent/5000000012902/photo
                  id: '5000000012902'
                  email: deskagent@zylker.com
  parameters:
    contactId:
      name: contactId
      in: path
      required: true
      style: simple
      explode: false
      schema:
        type:
        - string
        - 'null'
        - integer
        format: int64
        pattern: ([0-9]+)
  requestBodies:
    addFollowers:
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              followerIds:
                type:
                - 'null'
                - array
                items:
                  type:
                  - string
                  - 'null'
                  - integer
                  format: int64
                  pattern: ([0-9]+)
                uniqueItems: true
            required:
            - followerIds
          examples:
            Valid requestBody Definitions:
              value:
                followerIds:
                - 5000000013292
    removeFollowers:
      content:
        application/json:
          schema:
            type:
            - 'null'
            - object
            additionalProperties: false
            properties:
              followerIds:
                type:
                - 'null'
                - array
                items:
                  type:
                  - string
                  - 'null'
                  - integer
                  format: int64
                  pattern: ([0-9]+)
                uniqueItems: true
            required:
            - followerIds
          examples:
            Valid requestBody Definitions:
              value:
                followerIds:
                - 5000000013292
  securitySchemes:
    iam-oauth2-schema:
      $ref: ./Common.json#/components/securitySchemes/iam-oauth2-schema
x-entity: Helpcenter