Webex Contact Center — Contact Service Queue

naftiko: 1.0.0-alpha2
info:
  label: Webex Contact Center — Contact Service Queue
  description: 'Webex Contact Center — Contact Service Queue. 30 operations. Lead operation: List Contact Service Queue(s).
    Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - Contact Service Queue
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WEBEX_API_KEY: WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: contact-center-contact-service-queue
    baseUri: ''
    description: Webex Contact Center — Contact Service Queue business capability. Self-contained, no shared references.
    resources:
    - name: organization-orgid-contact-service-queue
      path: /organization/{orgid}/contact-service-queue
      operations:
      - name: getallfilteredconfig1
        method: GET
        description: List Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: filter
          in: query
          type: string
          description: 'Specify a filter based on which the results will be fetched. Supported filterable fields:  id. '
        - name: channelTypes
          in: query
          type: array
          description: '[DEPRECATED] Channel type(s) allowed by the system.Separate values with commas.Use uppercase. By default,
            there is no channel type filtering.'
        - name: attributes
          in: query
          type: string
          description: Specify the attributes to be returned. By default, all attributes are returned along with the specified
            columns. All attributes are supported. except (callDistr
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
        - name: singleObjectResponse
          in: query
          type: boolean
          description: Specifiy whether to include array fields in the response, This query param should use only if the response
            contain single record, if we are using for multiple o
      - name: createconfig16
        method: POST
        description: Create a new Contact Service Queue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-contact-service-queue-bulk
      path: /organization/{orgid}/contact-service-queue/bulk
      operations:
      - name: saveallconfig16
        method: POST
        description: Bulk save Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: patchallconfig1
        method: PATCH
        description: Bulk partial update Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-contact-service-queue-bulk-export
      path: /organization/{orgid}/contact-service-queue/bulk-export
      operations:
      - name: bulkexport14
        method: GET
        description: Bulk export Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: type
          in: query
          type: string
          description: Indicates the queue type; can be INBOUND or OUTBOUND.
          required: true
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
    - name: organization-orgid-contact-service-queue-by-skill-profile-id-id
      path: /organization/{orgid}/contact-service-queue/by-skill-profile-id/{id}
      operations:
      - name: getskillbasedcsqsbyskillprofileidpublic
        method: GET
        description: List Skill CSQs by Skill Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: ID of this contact center resource.
          required: true
    - name: organization-orgid-contact-service-queue-by-skill-profile-id-id-internal
      path: /organization/{orgid}/contact-service-queue/by-skill-profile-id/{id}/internal
      operations:
      - name: getskillbasedcsqsbyskillprofileid
        method: GET
        description: List Internal Skill CSQs by Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: ID of this contact center resource.
          required: true
    - name: organization-orgid-contact-service-queue-by-team-id-id-internal
      path: /organization/{orgid}/contact-service-queue/by-team-id/{id}/internal
      operations:
      - name: getteambasedcsqbyteamid
        method: GET
        description: List Team CSQs by Team ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: ID of this contact center resource.
          required: true
    - name: organization-orgid-contact-service-queue-by-user-ci-id-ciUserId-internal
      path: /organization/{orgid}/contact-service-queue/by-user-ci-id/{ciUserId}/internal
      operations:
      - name: getagentbasedcsqsbyciuserid
        method: GET
        description: List Agent CSQs by CI User ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: ciUserId
          in: path
          type: string
          description: ciUserId
          required: true
    - name: organization-orgid-contact-service-queue-delete-reference
      path: /organization/{orgid}/contact-service-queue/delete-reference
      operations:
      - name: deletereferences
        method: POST
        description: Delete CSQ References
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-contact-service-queue-fetch-by-dynamic-skills-and-skillProfil
      path: /organization/{orgid}/contact-service-queue/fetch-by-dynamic-skills-and-skillProfile
      operations:
      - name: getskillbasedcsqsbydynamicskillsandskillprofile
        method: POST
        description: List CSQs by Skills and Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-contact-service-queue-fetch-by-userId-skillProfileId
      path: /organization/{orgid}/contact-service-queue/fetch-by-userId-skillProfileId
      operations:
      - name: getskillbasedcsqsbyskillprofileidanduserid
        method: POST
        description: List CSQs by User and Profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-contact-service-queue-fetch-manually-assignable-queues
      path: /organization/{orgid}/contact-service-queue/fetch-manually-assignable-queues
      operations:
      - name: getmanuallyassignablecsqs
        method: POST
        description: List Manually Assignable CSQs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-contact-service-queue-purge-inactive-entities
      path: /organization/{orgid}/contact-service-queue/purge-inactive-entities
      operations:
      - name: purgeinactiveconfig8
        method: POST
        description: Purge inactive Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: nextStartId
          in: query
          type: string
          description: This is the entity ID from which items for the next purge batch with be selected.
    - name: organization-orgid-contact-service-queue-skill-based-queues-by-ci-user-id-id-int
      path: /organization/{orgid}/contact-service-queue/skill-based-queues/by-ci-user-id/{id}/internal
      operations:
      - name: getskillbasedcsqsbyciuserid
        method: GET
        description: List Skill CSQs by CI User ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: ID of this contact center resource.
          required: true
    - name: organization-orgid-contact-service-queue-v2-bulk
      path: /organization/{orgid}/contact-service-queue/v2/bulk
      operations:
      - name: saveallconfigv2
        method: POST
        description: Bulk save Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-contact-service-queue-id
      path: /organization/{orgid}/contact-service-queue/{id}
      operations:
      - name: getconfig18
        method: GET
        description: Get specific Contact Service Queue by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: Resource ID of the Contact Service Queue.
          required: true
        - name: agentsUpdatedInfo
          in: query
          type: boolean
          description: If `true`, returns the user details who has last updated the agents list in an agent based queue.
      - name: updateconfig18
        method: PUT
        description: Update specific Contact Service Queue by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: Resource ID of the Contact Service Queue.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteconfig16
        method: DELETE
        description: Delete specific Contact Service Queue by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: Resource ID of the Contact Service Queue.
          required: true
    - name: organization-orgid-contact-service-queue-id-incoming-references
      path: /organization/{orgid}/contact-service-queue/{id}/incoming-references
      operations:
      - name: getincomingreferences14
        method: GET
        description: List CSQ References by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: ID of this contact center resource.
          required: true
        - name: type
          in: query
          type: string
          description: Entity type of the other entity that has a reference to this specific entity.
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
    - name: organization-orgid-v2-contact-service-queue
      path: /organization/{orgid}/v2/contact-service-queue
      operations:
      - name: getallfilteredconfigwithpagedmetadata
        method: GET
        description: List Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: filter
          in: query
          type: string
          description: 'Specify a filter based on which the results will be fetched. All the fields are supported except:
            organizationId, queueSkillRequirements, xspVersion, createdTim'
        - name: attributes
          in: query
          type: string
          description: Specify the attributes to be returned. By default, all attributes are returned along with the specified
            columns. All attributes are supported. except (callDistr
        - name: search
          in: query
          type: string
          description: Filter data based on the search keyword.Supported search columns(name, description)
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
        - name: desktopProfileFilter
          in: query
          type: boolean
          description: If set to true, the API will return only the data that the user has access to according to its Desktop
            Profile. If unspecified, the default value is false.
        - name: provisioningView
          in: query
          type: boolean
          description: If set to true, the API will only return data that user has access to, according to User Profile. This
            query parameter is applicable only when desktopProfileFil
        - name: singleObjectResponse
          in: query
          type: boolean
          description: Specifiy whether to include array fields in the response, This query param should use only if the response
            contain single record, if we are using for multiple o
        - name: includeAIMappingCount
          in: query
          type: boolean
          description: If set to true, the API response will include the count of each AI features mapped to the entity.
      - name: createconfig17
        method: POST
        description: Create a new Contact Service Queue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-v2-contact-service-queue-by-user-id-userid-agent-based-queues
      path: /organization/{orgid}/v2/contact-service-queue/by-user-id/{userid}/agent-based-queues
      operations:
      - name: getcsqbyuseridforagentbasedqueue
        method: GET
        description: List agent based Contact Service Queue(s)by user ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: userid
          in: path
          type: string
          required: true
        - name: search
          in: query
          type: string
          description: Filter data based on the search keyword.Supported search columns(firstName, lastName, email)
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
    - name: organization-orgid-v2-contact-service-queue-by-user-id-userid-skill-based-queues
      path: /organization/{orgid}/v2/contact-service-queue/by-user-id/{userid}/skill-based-queues
      operations:
      - name: getskillbasedqueuesbyuserid
        method: GET
        description: List skill based Contact Service Queue(s)by user ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: userid
          in: path
          type: string
          required: true
        - name: search
          in: query
          type: string
          description: Filter data based on the search keyword.Supported search columns(firstName, lastName, email)
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
    - name: organization-orgid-v2-contact-service-queue-by-user-id-userid-team-based-queues
      path: /organization/{orgid}/v2/contact-service-queue/by-user-id/{userid}/team-based-queues
      operations:
      - name: getcsqbyuseridforteambasedqueue
        method: GET
        description: List team based Contact Service Queue(s)by user ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: userid
          in: path
          type: string
          required: true
        - name: search
          in: query
          type: string
          description: Filter data based on the search keyword.Supported search columns(firstName, lastName, email)
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
    - name: organization-orgid-v2-contact-service-queue-fetch-by-grouped-assistant-skill
      path: /organization/{orgid}/v2/contact-service-queue/fetch-by-grouped-assistant-skill
      operations:
      - name: getallcsqgroupedassistantskill
        method: POST
        description: List queue mapping summary grouped by Assistant Skill
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than allowed
            max page size, the API will automatically adjust the page si
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-v2-contact-service-queue-id
      path: /organization/{orgid}/v2/contact-service-queue/{id}
      operations:
      - name: getconfig19
        method: GET
        description: Get specific Contact Service Queue by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: Resource ID of the Contact Service Queue.
          required: true
        - name: agentsUpdatedInfo
          in: query
          type: boolean
          description: If `true`, returns the user details who has last updated the agents list in an agent based queue.
      - name: updateconfig19
        method: PUT
        description: Update specific Contact Service Queue by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: Resource ID of the Contact Service Queue.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-v2-contact-service-queue-id-reassign-agents
      path: /organization/{orgid}/v2/contact-service-queue/{id}/reassign-agents
      operations:
      - name: reassignagents
        method: POST
        description: Add or remove agents/users to/from an agent based queue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: id
          in: path
          type: string
          description: Resource ID of the Contact Service Queue.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: organization-orgid-v3-contact-service-queue
      path: /organization/{orgid}/v3/contact-service-queue
      operations:
      - name: getallfilteredconfigwithmetadatav3
        method: GET
        description: List Contact Service Queue(s)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgid
          in: path
          type: string
          description: Organization ID to be used for this operation. The specified security token must have permission to
            interact with the organization.
          required: true
        - name: filter
          in: query
          type: string
          description: 'Specify a filter based on which the results will be fetched. All the fields are supported except:
            organizationId, queueSkillRequirements, xspVersion, createdTim'
        - name: attributes
          in: query
          type: string
          description: Specify the attributes to be returned. By default, all attributes are returned along with the specified
            columns. All attributes are supported. except (callDistr
        - name: search
          in: query
          type: string
          description: Filter data based on the search keyword.Supported search columns(name, description)
        - name: page
          in: query
          type: integer
          description: Defines the number of displayed page. The page number starts from 0.
        - name: pageSize
          in: query
          type: integer
          description: Defines the number of items to be displayed on a page. If the number specified is more than al

# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/webex/refs/heads/main/capabilities/contact-center-contact-service-queue.yaml