Webex Cloud Calling — User Call Settings (2/2)

naftiko: 1.0.0-alpha2
info:
  label: Webex Cloud Calling — User Call Settings (2/2)
  description: 'Webex Cloud Calling — User Call Settings (2/2). 94 operations. Lead operation: Retrieve a person''s Application
    Services Settings New. Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - User Call Settings (2/2)
  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-user-call-settings-2-2
    baseUri: ''
    description: Webex Cloud Calling — User Call Settings (2/2) business capability. Self-contained, no shared references.
    resources:
    - name: people-personId-features-applications
      path: /people/{personId}/features/applications
      operations:
      - name: getpersonsappservicessettingsnew
        method: GET
        description: Retrieve a person's Application Services Settings New
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: ID of the organization in which the person resides. Only admin users of another organization (such
            as partners) may use this parameter as the default is the sam
    - name: telephony-config-countries-countryCode
      path: /telephony/config/countries/{countryCode}
      operations:
      - name: getcountryconfiguration
        method: GET
        description: Get Country Calling Configuration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: countryCode
          in: path
          type: string
          description: The ISO country code to retrieve configuration for.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID. If not specified, uses the organization from the OAuth token.
    - name: telephony-config-jobs-person-moveLocation
      path: /telephony/config/jobs/person/moveLocation
      operations:
      - name: validateorinitiatemoveusersjob
        method: POST
        description: Validate or Initiate Move Users Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: Create Move Users job for this organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: listmoveusersjobs
        method: GET
        description: List Move Users Jobs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: Retrieve list of Move Users 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-person-moveLocation-jobId
      path: /telephony/config/jobs/person/moveLocation/{jobId}
      operations:
      - name: getmoveusersjobstatus
        method: GET
        description: Get Move Users 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: orgId
          in: query
          type: string
          description: Retrieve job details for this organization.
    - name: telephony-config-jobs-person-moveLocation-jobId-actions-pause-invoke
      path: /telephony/config/jobs/person/moveLocation/{jobId}/actions/pause/invoke
      operations:
      - name: pausemoveusersjob
        method: POST
        description: Pause the Move Users Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: jobId
          in: path
          type: string
          description: Pause the Move Users job for this `jobId`.
          required: true
        - name: orgId
          in: query
          type: string
          description: Pause the Move Users job for this organization.
    - name: telephony-config-jobs-person-moveLocation-jobId-actions-resume-invoke
      path: /telephony/config/jobs/person/moveLocation/{jobId}/actions/resume/invoke
      operations:
      - name: resumemoveusersjob
        method: POST
        description: Resume the Move Users Job
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: jobId
          in: path
          type: string
          description: Resume the Move Users job for this `jobId`.
          required: true
        - name: orgId
          in: query
          type: string
          description: Resume the Move Users job for this organization.
    - name: telephony-config-jobs-person-moveLocation-jobId-errors
      path: /telephony/config/jobs/person/moveLocation/{jobId}/errors
      operations:
      - name: listmoveusersjoberrors
        method: GET
        description: List Move Users Job errors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: jobId
          in: path
          type: string
          description: Retrieve the error details for this `jobId`.
          required: true
        - name: orgId
          in: query
          type: string
          description: Retrieve list of jobs for this organization.
        - name: start
          in: query
          type: number
          description: Specifies the error offset from the first result that you want to fetch.
        - name: max
          in: query
          type: number
          description: Specifies the maximum number of records that you want to fetch.
    - name: telephony-config-people-primary-availableNumbers
      path: /telephony/config/people/primary/availableNumbers
      operations:
      - name: getpersonprimaryavailablephonenumbers
        method: GET
        description: Get Person Primary Available Phone Numbers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: query
          type: string
          description: List numbers for this organization.
        - name: locationId
          in: query
          type: string
          description: Return the list of phone numbers for this location within the given organization. The maximum length
            is 36.
        - name: max
          in: query
          type: number
          description: Limit the number of phone numbers returned to this maximum count. The default is 2000.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of matching phone numbers. The default is 0.
        - name: phoneNumber
          in: query
          type: array
          description: Filter phone numbers based on the comma-separated list provided in the `phoneNumber` array.
        - name: licenseType
          in: query
          type: string
          description: Used to search numbers according to the person's `licenseType` to which the number will be assigned.
    - name: telephony-config-people-personId
      path: /telephony/config/people/{personId}
      operations:
      - name: gettimezoneannouncementlanguagesettingsofaperson
        method: GET
        description: Get Timezone and Announcement Language Settings of a Person
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Retrieve timezone and announcement language settings of this person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID. If not specified, uses the organization from the OAuth token.
      - name: modifytimezoneannouncementlanguagesettingsofaperson
        method: PUT
        description: Update Timezone and Announcement Language Settings of a Person
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Modify timezone and announcement language settings of this person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID. If not specified, uses the organization from the OAuth token.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-agent-availableCallerIds
      path: /telephony/config/people/{personId}/agent/availableCallerIds
      operations:
      - name: retrieveagentslistofavailablecallerids
        method: GET
        description: Retrieve Agent's List of Available Caller IDs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: ID of the organization in which the person resides. Only admin users of another organization (such
            as partners) may use this parameter as the default is the sam
    - name: telephony-config-people-personId-agent-callerId
      path: /telephony/config/people/{personId}/agent/callerId
      operations:
      - name: retrieveagentscalleridinformation
        method: GET
        description: Retrieve Agent's Caller ID Information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
      - name: modifyagentcalleridinformation
        method: PUT
        description: Modify Agent's Caller ID Information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-applications-availableMembers
      path: /telephony/config/people/{personId}/applications/availableMembers
      operations:
      - name: searchsharedlineappearancemembersnew
        method: GET
        description: Search Shared-Line Appearance Members New
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: max
          in: query
          type: number
          description: Limit the number of objects returned to this maximum count.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of matching objects.
        - name: order
          in: query
          type: string
          description: Order the Route Lists according to number, ascending or descending.
        - name: location
          in: query
          type: string
          description: Location ID for the user.
        - name: name
          in: query
          type: string
          description: Search for users with names that match the query.
        - name: phoneNumber
          in: query
          type: string
          description: Search for users with numbers that match the query.
        - name: extension
          in: query
          type: string
          description: Search for users with extensions that match the query.
    - name: telephony-config-people-personId-applications-availableMembers-count
      path: /telephony/config/people/{personId}/applications/availableMembers/count
      operations:
      - name: getcountofsharedlineappearancemembersnew
        method: GET
        description: Get Count of Shared-Line Appearance Members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
        - name: locationId
          in: query
          type: string
          description: Location ID for the person.
        - name: memberName
          in: query
          type: string
          description: Search for people with names that match the query.
        - name: phoneNumber
          in: query
          type: string
          description: Search for people with numbers that match the query.
        - name: extension
          in: query
          type: string
          description: Search for people with extensions that match the query.
    - name: telephony-config-people-personId-applications-members
      path: /telephony/config/people/{personId}/applications/members
      operations:
      - name: getsharedlineappearancemembersnew
        method: GET
        description: Get Shared-Line Appearance Members New
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
      - name: putsharedlineappearancemembersnew
        method: PUT
        description: Put Shared-Line Appearance Members New
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-applications-applicationId-availableMembers
      path: /telephony/config/people/{personId}/applications/{applicationId}/availableMembers
      operations:
      - name: searchsharedlineappearancemembers
        method: GET
        description: Search Shared-Line Appearance Members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: applicationId
          in: path
          type: string
          description: A unique identifier for the application.
          required: true
        - name: max
          in: query
          type: number
          description: Number of records per page.
        - name: start
          in: query
          type: number
          description: Page number.
        - name: location
          in: query
          type: string
          description: Location ID for the user.
        - name: name
          in: query
          type: string
          description: Search for users with names that match the query.
        - name: number
          in: query
          type: string
          description: Search for users with numbers that match the query.
        - name: order
          in: query
          type: string
          description: Sort by first name (`fname`) or last name (`lname`).
        - name: extension
          in: query
          type: string
          description: Search for users with extensions that match the query.
    - name: telephony-config-people-personId-applications-applicationId-members
      path: /telephony/config/people/{personId}/applications/{applicationId}/members
      operations:
      - name: getsharedlineappearancemembers
        method: GET
        description: Get Shared-Line Appearance Members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: applicationId
          in: path
          type: string
          description: A unique identifier for the application.
          required: true
      - name: modifysharedlineappearancemembers
        method: PUT
        description: Put Shared-Line Appearance Members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: applicationId
          in: path
          type: string
          description: A unique identifier for the application.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-callCaptions
      path: /telephony/config/people/{personId}/callCaptions
      operations:
      - name: getusercallcaptionssettings
        method: GET
        description: Get the user call captions settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Unique identifier for the organization.
      - name: modifyusercallcaptionssettings
        method: PUT
        description: Update the user call captions settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Unique identifier for the organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-callForwarding-availableNumbers
      path: /telephony/config/people/{personId}/callForwarding/availableNumbers
      operations:
      - name: getpersoncallforwardavailablephonenumbers
        method: GET
        description: Get Person Call Forward Available Phone Numbers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: List numbers for this organization.
        - name: max
          in: query
          type: number
          description: Limit the number of phone numbers returned to this maximum count. The default is 2000.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of matching phone numbers. The default is 0.
        - name: phoneNumber
          in: query
          type: array
          description: Filter phone numbers based on the comma-separated list provided in the `phoneNumber` array.
        - name: ownerName
          in: query
          type: string
          description: Return the list of phone numbers that are owned by the given `ownerName`. Maximum length is 255.
        - name: extension
          in: query
          type: string
          description: Returns the list of PSTN phone numbers with the given `extension`.
    - name: telephony-config-people-personId-callIntercept-availableNumbers
      path: /telephony/config/people/{personId}/callIntercept/availableNumbers
      operations:
      - name: getpersoncallinterceptavailablephonenumbers
        method: GET
        description: Get Person Call Intercept Available Phone Numbers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: List numbers for this organization.
        - name: max
          in: query
          type: number
          description: Limit the number of phone numbers returned to this maximum count. The default is 2000.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of matching phone numbers. The default is 0.
        - name: phoneNumber
          in: query
          type: array
          description: Filter phone numbers based on the comma-separated list provided in the `phoneNumber` array.
        - name: ownerName
          in: query
          type: string
          description: Return the list of phone numbers that are owned by the given `ownerName`. Maximum length is 255.
        - name: extension
          in: query
          type: string
          description: Returns the list of PSTN phone numbers with the given `extension`.
    - name: telephony-config-people-personId-emergencyCallbackNumber-availableNumbers
      path: /telephony/config/people/{personId}/emergencyCallbackNumber/availableNumbers
      operations:
      - name: getpersonecbnavailablephonenumbers
        method: GET
        description: Get Person ECBN Available Phone Numbers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: List numbers for this organization.
        - name: max
          in: query
          type: number
          description: Limit the number of phone numbers returned to this maximum count. The default is 2000.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of matching phone numbers. The default is 0.
        - name: phoneNumber
          in: query
          type: array
          description: Filter phone numbers based on the comma-separated list provided in the `phoneNumber` array.
        - name: ownerName
          in: query
          type: string
          description: Return the list of phone numbers that are owned by the given `ownerName`. Maximum length is 255.
    - name: telephony-config-people-personId-executive-alert
      path: /telephony/config/people/{personId}/executive/alert
      operations:
      - name: getpersonexecutivealertsettings
        method: GET
        description: Get Person Executive Alert Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
      - name: updatepersonexecutivealertsettings
        method: PUT
        description: Modify Person Executive Alert Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-executive-assignedAssistants
      path: /telephony/config/people/{personId}/executive/assignedAssistants
      operations:
      - name: getpersonexecutiveassignedassistants
        method: GET
        description: Get Person Executive Assigned Assistants
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
      - name: modifypersonexecutiveassignedassistants
        method: PUT
        description: Modify Person Executive Assigned Assistants
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-executive-assistant
      path: /telephony/config/people/{personId}/executive/assistant
      operations:
      - name: getpersonexecutiveassistantsettings
        method: GET
        description: Get Person Executive Assistant Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
      - name: modifypersonexecutiveassistantsettings
        method: PUT
        description: Modify Person Executive Assistant Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-executive-availableAssistants
      path: /telephony/config/people/{personId}/executive/availableAssistants
      operations:
      - name: getpersonexecutiveavailableassistants
        method: GET
        description: Get Person Executive Available Assistants
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the person.
        - name: max
          in: query
          type: number
          description: Limit the number of objects returned to this maximum count.
        - name: start
          in: query
          type: number
          description: Start at the zero-based offset in the list of matching objects.
        - name: name
          in: query
          type: string
          description: Only return people with the matching name (person's first and last name combination).
        - name: phoneNumber
          in: query
          type: string
          description: Only return people with the matching phone number or extension.
    - name: telephony-config-people-personId-executive-callFiltering
      path: /telephony/config/people/{personId}/executive/callFiltering
      operations:
      - name: getpersonexecutivecallfilteringsettings
        method: GET
        description: Get Person Executive Call Filtering Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the user.
      - name: updatepersonexecutivecallfilteringsettings
        method: PUT
        description: Modify Person Executive Call Filtering Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the user.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: telephony-config-people-personId-executive-callFiltering-criteria
      path: /telephony/config/people/{personId}/executive/callFiltering/criteria
      operations:
      - name: createpersonexecutivecallfilteringcriteria
        method: POST
        description: Add Person Executive Call Filtering Criteria
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: A unique identifier for the person.
          required: true
        - name: orgId
          in: query
          type: string
          description: Organization ID for the user.
        - name: body
          in: 

# --- truncated at 32 KB (169 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/webex/refs/heads/main/capabilities/cloud-calling-user-call-settings-2-2.yaml