naftiko: 1.0.0-alpha2
info:
  label: Webex Contact Center — Auxiliary Code
  description: 'Webex Contact Center — Auxiliary Code. 11 operations. Lead operation: List Auxiliary Code(s). Self-contained
    Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - Auxiliary Code
  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-auxiliary-code
    baseUri: ''
    description: Webex Contact Center — Auxiliary Code business capability. Self-contained, no shared references.
    resources:
    - name: organization-orgid-auxiliary-code
      path: /organization/{orgid}/auxiliary-code
      operations:
      - name: getallconfig12
        method: GET
        description: List Auxiliary Code(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: attributes
          in: query
          type: string
          description: Specify the attributes to be returned.Default all attributes are returned along with specified columns.
            All Attributes are supported
        - 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: createconfig23
        method: POST
        description: Create a new Auxiliary Code
        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-auxiliary-code-bulk
      path: /organization/{orgid}/auxiliary-code/bulk
      operations:
      - name: saveallconfig20
        method: POST
        description: Bulk save Auxiliary Code(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: patchallconfig2
        method: PATCH
        description: Bulk partial update Auxiliary Code(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-auxiliary-code-bulk-export
      path: /organization/{orgid}/auxiliary-code/bulk-export
      operations:
      - name: bulkexport20
        method: GET
        description: Bulk export Auxiliary Code(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: 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-auxiliary-code-purge-inactive-entities
      path: /organization/{orgid}/auxiliary-code/purge-inactive-entities
      operations:
      - name: purgeinactiveconfig10
        method: POST
        description: Purge inactive Auxiliary Code(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-auxiliary-code-id
      path: /organization/{orgid}/auxiliary-code/{id}
      operations:
      - name: getconfig24
        method: GET
        description: Get specific Auxiliary Code 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 Auxiliary Code
          required: true
      - name: updateconfig24
        method: PUT
        description: Update specific Auxiliary Code 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 Auxiliary Code.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteconfig22
        method: DELETE
        description: Delete specific Auxiliary Code 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 Auxiliary Code.
          required: true
    - name: organization-orgid-auxiliary-code-id-incoming-references
      path: /organization/{orgid}/auxiliary-code/{id}/incoming-references
      operations:
      - name: getincomingreferences18
        method: GET
        description: List references for a specific Auxiliary Code
        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-auxiliary-code
      path: /organization/{orgid}/v2/auxiliary-code
      operations:
      - name: getallconfigwithmetadata21
        method: GET
        description: List Auxiliary Code(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, createdTime, lastUpdatedTime, validBurnoutForW'
        - name: attributes
          in: query
          type: string
          description: Specify the attributes to be returned.Default all attributes are returned along with specified columns.
            All Attributes are supported
        - 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 set to false, the API will not check for Desk
        - name: supervisedUserId
          in: query
          type: string
          description: User Id of the Agent whose Agent Profile associated Idle Codes are to be fetched.
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: contact-center-auxiliary-code-rest
    port: 8080
    description: REST adapter for Webex Contact Center — Auxiliary Code. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/organization/{orgid}/auxiliary-code
      name: organization-orgid-auxiliary-code
      description: REST surface for organization-orgid-auxiliary-code.
      operations:
      - method: GET
        name: getallconfig12
        description: List Auxiliary Code(s)
        call: contact-center-auxiliary-code.getallconfig12
        with:
          orgid: rest.orgid
          filter: rest.filter
          attributes: rest.attributes
          page: rest.page
          pageSize: rest.pageSize
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createconfig23
        description: Create a new Auxiliary Code
        call: contact-center-auxiliary-code.createconfig23
        with:
          orgid: rest.orgid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organization/{orgid}/auxiliary-code/bulk
      name: organization-orgid-auxiliary-code-bulk
      description: REST surface for organization-orgid-auxiliary-code-bulk.
      operations:
      - method: POST
        name: saveallconfig20
        description: Bulk save Auxiliary Code(s)
        call: contact-center-auxiliary-code.saveallconfig20
        with:
          orgid: rest.orgid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchallconfig2
        description: Bulk partial update Auxiliary Code(s)
        call: contact-center-auxiliary-code.patchallconfig2
        with:
          orgid: rest.orgid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organization/{orgid}/auxiliary-code/bulk-export
      name: organization-orgid-auxiliary-code-bulk-export
      description: REST surface for organization-orgid-auxiliary-code-bulk-export.
      operations:
      - method: GET
        name: bulkexport20
        description: Bulk export Auxiliary Code(s)
        call: contact-center-auxiliary-code.bulkexport20
        with:
          orgid: rest.orgid
          page: rest.page
          pageSize: rest.pageSize
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organization/{orgid}/auxiliary-code/purge-inactive-entities
      name: organization-orgid-auxiliary-code-purge-inactive-entities
      description: REST surface for organization-orgid-auxiliary-code-purge-inactive-entities.
      operations:
      - method: POST
        name: purgeinactiveconfig10
        description: Purge inactive Auxiliary Code(s)
        call: contact-center-auxiliary-code.purgeinactiveconfig10
        with:
          orgid: rest.orgid
          nextStartId: rest.nextStartId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organization/{orgid}/auxiliary-code/{id}
      name: organization-orgid-auxiliary-code-id
      description: REST surface for organization-orgid-auxiliary-code-id.
      operations:
      - method: GET
        name: getconfig24
        description: Get specific Auxiliary Code by ID
        call: contact-center-auxiliary-code.getconfig24
        with:
          orgid: rest.orgid
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateconfig24
        description: Update specific Auxiliary Code by ID
        call: contact-center-auxiliary-code.updateconfig24
        with:
          orgid: rest.orgid
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteconfig22
        description: Delete specific Auxiliary Code by ID
        call: contact-center-auxiliary-code.deleteconfig22
        with:
          orgid: rest.orgid
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organization/{orgid}/auxiliary-code/{id}/incoming-references
      name: organization-orgid-auxiliary-code-id-incoming-references
      description: REST surface for organization-orgid-auxiliary-code-id-incoming-references.
      operations:
      - method: GET
        name: getincomingreferences18
        description: List references for a specific Auxiliary Code
        call: contact-center-auxiliary-code.getincomingreferences18
        with:
          orgid: rest.orgid
          id: rest.id
          type: rest.type
          page: rest.page
          pageSize: rest.pageSize
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/organization/{orgid}/v2/auxiliary-code
      name: organization-orgid-v2-auxiliary-code
      description: REST surface for organization-orgid-v2-auxiliary-code.
      operations:
      - method: GET
        name: getallconfigwithmetadata21
        description: List Auxiliary Code(s)
        call: contact-center-auxiliary-code.getallconfigwithmetadata21
        with:
          orgid: rest.orgid
          filter: rest.filter
          attributes: rest.attributes
          search: rest.search
          page: rest.page
          pageSize: rest.pageSize
          desktopProfileFilter: rest.desktopProfileFilter
          supervisedUserId: rest.supervisedUserId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: contact-center-auxiliary-code-mcp
    port: 9090
    transport: http
    description: MCP adapter for Webex Contact Center — Auxiliary Code. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-auxiliary-code-s
      description: List Auxiliary Code(s)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contact-center-auxiliary-code.getallconfig12
      with:
        orgid: tools.orgid
        filter: tools.filter
        attributes: tools.attributes
        page: tools.page
        pageSize: tools.pageSize
      outputParameters:
      - type: object
        mapping: $.
    - name: create-new-auxiliary-code
      description: Create a new Auxiliary Code
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: contact-center-auxiliary-code.createconfig23
      with:
        orgid: tools.orgid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: bulk-save-auxiliary-code-s
      description: Bulk save Auxiliary Code(s)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: contact-center-auxiliary-code.saveallconfig20
      with:
        orgid: tools.orgid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: bulk-partial-update-auxiliary-code-s
      description: Bulk partial update Auxiliary Code(s)
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: contact-center-auxiliary-code.patchallconfig2
      with:
        orgid: tools.orgid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: bulk-export-auxiliary-code-s
      description: Bulk export Auxiliary Code(s)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contact-center-auxiliary-code.bulkexport20
      with:
        orgid: tools.orgid
        page: tools.page
        pageSize: tools.pageSize
      outputParameters:
      - type: object
        mapping: $.
    - name: purge-inactive-auxiliary-code-s
      description: Purge inactive Auxiliary Code(s)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: contact-center-auxiliary-code.purgeinactiveconfig10
      with:
        orgid: tools.orgid
        nextStartId: tools.nextStartId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-specific-auxiliary-code-id
      description: Get specific Auxiliary Code by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contact-center-auxiliary-code.getconfig24
      with:
        orgid: tools.orgid
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: update-specific-auxiliary-code-id
      description: Update specific Auxiliary Code by ID
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: contact-center-auxiliary-code.updateconfig24
      with:
        orgid: tools.orgid
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-specific-auxiliary-code-id
      description: Delete specific Auxiliary Code by ID
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: contact-center-auxiliary-code.deleteconfig22
      with:
        orgid: tools.orgid
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-references-specific-auxiliary-code
      description: List references for a specific Auxiliary Code
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contact-center-auxiliary-code.getincomingreferences18
      with:
        orgid: tools.orgid
        id: tools.id
        type: tools.type
        page: tools.page
        pageSize: tools.pageSize
      outputParameters:
      - type: object
        mapping: $.
    - name: list-auxiliary-code-s-2
      description: List Auxiliary Code(s)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: contact-center-auxiliary-code.getallconfigwithmetadata21
      with:
        orgid: tools.orgid
        filter: tools.filter
        attributes: tools.attributes
        search: tools.search
        page: tools.page
        pageSize: tools.pageSize
        desktopProfileFilter: tools.desktopProfileFilter
        supervisedUserId: tools.supervisedUserId
      outputParameters:
      - type: object
        mapping: $.