Webex Cloud Calling — Device Call Settings With Device Dynamic Settings

naftiko: 1.0.0-alpha2
info:
  label: Webex Cloud Calling — Device Call Settings With Device Dynamic Settings
  description: 'Webex Cloud Calling — Device Call Settings With Device Dynamic Settings. 10 operations. Lead operation: Get
    Settings Groups. Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - Device Call Settings With Device Dynamic Settings
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WEBEX_API_KEY: WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: cloud-calling-device-call-settings-with-device-dynamic-settings
    baseUri: ''
    description: Webex Cloud Calling — Device Call Settings With Device Dynamic Settings business capability. Self-contained,
      no shared references.
    resources:
    - name: telephony-config-devices-dynamicSettings-settingsGroups
      path: /telephony/config/devices/dynamicSettings/settingsGroups
      operations:
      - name: getsettingsgroups
        method: GET
        description: Get Settings Groups
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: Settings groups for devices in this organization.
        - name: familyOrModelDisplayName
          in: query
          type: string
          description: Device family or model display name to filter the `settingsGroups`.
        - name: includeSettingsType
          in: query
          type: string
          description: To show groups or tabs or both. Query param is case insensitive. Default is `ALL`.
    - name: telephony-config-devices-deviceId-dynamicSettings
      path: /telephony/config/devices/{deviceId}/dynamicSettings
      operations:
      - name: updatespecifiedsettingsforthedevice
        method: PUT
        description: Update Device Dynamic Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deviceId
          in: path
          type: string
          description: Device for which to update settings.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization to which the device belongs.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-config-jobs-devices-dynamicDeviceSettings
      path: /telephony/config/jobs/devices/dynamicDeviceSettings
      operations:
      - name: updatesdynamicdevicesettingsacrossorganizationorlocation
        method: POST
        description: Update Device Dynamic Settings Across Organization or Location
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: Apply update device dynamic settings for all the devices under this organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: listdynamicdevicesettingsjobs
        method: GET
        description: List Device Dynamic Settings Jobs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: Retrieve list of device dynamic settings jobs for this organization.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of jobs. Default is 0.
        - name: max
          in: query
          type: number
          description: Limit the number of jobs returned to this maximum count. Default is 2000.
    - name: telephony-config-jobs-devices-dynamicDeviceSettings-jobId
      path: /telephony/config/jobs/devices/dynamicDeviceSettings/{jobId}
      operations:
      - name: getdevicedynamicsettingsjobstatus
        method: GET
        description: Get Device Dynamic Settings Job Status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: jobId
          in: path
          type: string
          description: Retrieve job details for this `jobId`.
          required: true
    - name: telephony-config-jobs-devices-dynamicDeviceSettings-jobId-errors
      path: /telephony/config/jobs/devices/dynamicDeviceSettings/{jobId}/errors
      operations:
      - name: listdynamicdevicesettingsjoberrors
        method: GET
        description: List Device Dynamic Settings Job Errors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: jobId
          in: path
          type: string
          description: Retrieve job details for this `jobId`.
          required: true
        - name: orgId
          in: query
          type: string
          description: Retrieve the status of job for this organization.
        - name: start
          in: query
          type: number
          description: Specifies the offset from the first result that you want to fetch. Default is 0.
        - name: max
          in: query
          type: number
          description: Specifies the maximum number of records that you want to fetch. Default is 2000
    - name: telephony-config-lists-devices-dynamicSettings-actions-getSettings-invoke
      path: /telephony/config/lists/devices/dynamicSettings/actions/getSettings/invoke
      operations:
      - name: getcustomerdevicedynamicsettings
        method: POST
        description: Get Customer Device Dynamic Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: List of device dynamic settings in this organization.
        - name: familyOrModelDisplayName
          in: query
          type: string
          description: The family or model name for the device. If no tag is specified, all tags related to `familyOrModelDisplayName`
            are returned.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-lists-devices-deviceId-dynamicSettings-actions-getSettings-invo
      path: /telephony/config/lists/devices/{deviceId}/dynamicSettings/actions/getSettings/invoke
      operations:
      - name: getdevicedynamicsettings
        method: POST
        description: Get Device Dynamic Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deviceId
          in: path
          type: string
          description: Device for which to retrieve settings.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization to which the `device` belongs.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-config-lists-locations-locationId-devices-dynamicSettings-actions-getS
      path: /telephony/config/lists/locations/{locationId}/devices/dynamicSettings/actions/getSettings/invoke
      operations:
      - name: getlocationdevicedynamicsettings
        method: POST
        description: Get Location Device Dynamic Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: locationId
          in: path
          type: string
          description: Unique identifier for the `location`.
          required: true
        - name: orgId
          in: query
          type: string
          description: Unique identifier for the `organization` to which this location belongs.
        - name: familyOrModelDisplayName
          in: query
          type: string
          description: The family or model name for the device. If no tag is specified, all tags related to `familyOrModelDisplayName`
            are returned.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-supportedDevices
      path: /telephony/config/supportedDevices
      operations:
      - name: readthelistofsupporteddevices
        method: GET
        description: Read the List of Supported Devices
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: List supported devices for an organization.
        - name: allowConfigureLayoutEnabled
          in: query
          type: boolean
          description: List supported devices that allow the user to configure the layout.
        - name: type
          in: query
          type: string
          description: List supported devices of a specific type. To excluded device types from a request or query, add `type=not:DEVICE_TYPE`.
            For example, `type=not:MPP`.
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: cloud-calling-device-call-settings-with-device-dynamic-settings-rest
    port: 8080
    description: REST adapter for Webex Cloud Calling — Device Call Settings With Device Dynamic Settings. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/telephony/config/devices/dynamicsettings/settingsgroups
      name: telephony-config-devices-dynamicsettings-settingsgroups
      description: REST surface for telephony-config-devices-dynamicSettings-settingsGroups.
      operations:
      - method: GET
        name: getsettingsgroups
        description: Get Settings Groups
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.getsettingsgroups
        with:
          orgId: rest.orgId
          familyOrModelDisplayName: rest.familyOrModelDisplayName
          includeSettingsType: rest.includeSettingsType
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/devices/{deviceid}/dynamicsettings
      name: telephony-config-devices-deviceid-dynamicsettings
      description: REST surface for telephony-config-devices-deviceId-dynamicSettings.
      operations:
      - method: PUT
        name: updatespecifiedsettingsforthedevice
        description: Update Device Dynamic Settings
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.updatespecifiedsettingsforthedevice
        with:
          deviceId: rest.deviceId
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/jobs/devices/dynamicdevicesettings
      name: telephony-config-jobs-devices-dynamicdevicesettings
      description: REST surface for telephony-config-jobs-devices-dynamicDeviceSettings.
      operations:
      - method: POST
        name: updatesdynamicdevicesettingsacrossorganizationorlocation
        description: Update Device Dynamic Settings Across Organization or Location
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.updatesdynamicdevicesettingsacrossorganizationorlocation
        with:
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: listdynamicdevicesettingsjobs
        description: List Device Dynamic Settings Jobs
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.listdynamicdevicesettingsjobs
        with:
          orgId: rest.orgId
          start: rest.start
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/jobs/devices/dynamicdevicesettings/{jobid}
      name: telephony-config-jobs-devices-dynamicdevicesettings-jobid
      description: REST surface for telephony-config-jobs-devices-dynamicDeviceSettings-jobId.
      operations:
      - method: GET
        name: getdevicedynamicsettingsjobstatus
        description: Get Device Dynamic Settings Job Status
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.getdevicedynamicsettingsjobstatus
        with:
          jobId: rest.jobId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/jobs/devices/dynamicdevicesettings/{jobid}/errors
      name: telephony-config-jobs-devices-dynamicdevicesettings-jobid-errors
      description: REST surface for telephony-config-jobs-devices-dynamicDeviceSettings-jobId-errors.
      operations:
      - method: GET
        name: listdynamicdevicesettingsjoberrors
        description: List Device Dynamic Settings Job Errors
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.listdynamicdevicesettingsjoberrors
        with:
          jobId: rest.jobId
          orgId: rest.orgId
          start: rest.start
          max: rest.max
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/lists/devices/dynamicsettings/actions/getsettings/invoke
      name: telephony-config-lists-devices-dynamicsettings-actions-getsettings-invoke
      description: REST surface for telephony-config-lists-devices-dynamicSettings-actions-getSettings-invoke.
      operations:
      - method: POST
        name: getcustomerdevicedynamicsettings
        description: Get Customer Device Dynamic Settings
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.getcustomerdevicedynamicsettings
        with:
          orgId: rest.orgId
          familyOrModelDisplayName: rest.familyOrModelDisplayName
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/lists/devices/{deviceid}/dynamicsettings/actions/getsettings/invoke
      name: telephony-config-lists-devices-deviceid-dynamicsettings-actions-getsettings-invo
      description: REST surface for telephony-config-lists-devices-deviceId-dynamicSettings-actions-getSettings-invo.
      operations:
      - method: POST
        name: getdevicedynamicsettings
        description: Get Device Dynamic Settings
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.getdevicedynamicsettings
        with:
          deviceId: rest.deviceId
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/lists/locations/{locationid}/devices/dynamicsettings/actions/getsettings/invoke
      name: telephony-config-lists-locations-locationid-devices-dynamicsettings-actions-gets
      description: REST surface for telephony-config-lists-locations-locationId-devices-dynamicSettings-actions-getS.
      operations:
      - method: POST
        name: getlocationdevicedynamicsettings
        description: Get Location Device Dynamic Settings
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.getlocationdevicedynamicsettings
        with:
          locationId: rest.locationId
          orgId: rest.orgId
          familyOrModelDisplayName: rest.familyOrModelDisplayName
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/supporteddevices
      name: telephony-config-supporteddevices
      description: REST surface for telephony-config-supportedDevices.
      operations:
      - method: GET
        name: readthelistofsupporteddevices
        description: Read the List of Supported Devices
        call: cloud-calling-device-call-settings-with-device-dynamic-settings.readthelistofsupporteddevices
        with:
          orgId: rest.orgId
          allowConfigureLayoutEnabled: rest.allowConfigureLayoutEnabled
          type: rest.type
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloud-calling-device-call-settings-with-device-dynamic-settings-mcp
    port: 9090
    transport: http
    description: MCP adapter for Webex Cloud Calling — Device Call Settings With Device Dynamic Settings. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: get-settings-groups
      description: Get Settings Groups
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.getsettingsgroups
      with:
        orgId: tools.orgId
        familyOrModelDisplayName: tools.familyOrModelDisplayName
        includeSettingsType: tools.includeSettingsType
      outputParameters:
      - type: object
        mapping: $.
    - name: update-device-dynamic-settings
      description: Update Device Dynamic Settings
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.updatespecifiedsettingsforthedevice
      with:
        deviceId: tools.deviceId
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-device-dynamic-settings-across
      description: Update Device Dynamic Settings Across Organization or Location
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.updatesdynamicdevicesettingsacrossorganizationorlocation
      with:
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-device-dynamic-settings-jobs
      description: List Device Dynamic Settings Jobs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.listdynamicdevicesettingsjobs
      with:
        orgId: tools.orgId
        start: tools.start
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.
    - name: get-device-dynamic-settings-job
      description: Get Device Dynamic Settings Job Status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.getdevicedynamicsettingsjobstatus
      with:
        jobId: tools.jobId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-device-dynamic-settings-job
      description: List Device Dynamic Settings Job Errors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.listdynamicdevicesettingsjoberrors
      with:
        jobId: tools.jobId
        orgId: tools.orgId
        start: tools.start
        max: tools.max
      outputParameters:
      - type: object
        mapping: $.
    - name: get-customer-device-dynamic-settings
      description: Get Customer Device Dynamic Settings
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.getcustomerdevicedynamicsettings
      with:
        orgId: tools.orgId
        familyOrModelDisplayName: tools.familyOrModelDisplayName
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-device-dynamic-settings
      description: Get Device Dynamic Settings
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.getdevicedynamicsettings
      with:
        deviceId: tools.deviceId
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-location-device-dynamic-settings
      description: Get Location Device Dynamic Settings
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.getlocationdevicedynamicsettings
      with:
        locationId: tools.locationId
        orgId: tools.orgId
        familyOrModelDisplayName: tools.familyOrModelDisplayName
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-list-supported-devices
      description: Read the List of Supported Devices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-device-call-settings-with-device-dynamic-settings.readthelistofsupporteddevices
      with:
        orgId: tools.orgId
        allowConfigureLayoutEnabled: tools.allowConfigureLayoutEnabled
        type: tools.type
      outputParameters:
      - type: object
        mapping: $.