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

naftiko: 1.0.0-alpha2
info:
  label: Webex Cloud Calling — User Call Settings (1/2)
  description: 'Webex Cloud Calling — User Call Settings (1/2). 49 operations. Lead operation: Modify a person''s Application
    Services Settings. Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - User Call Settings (1/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-1-2
    baseUri: ''
    description: Webex Cloud Calling — User Call Settings (1/2) business capability. Self-contained, no shared references.
    resources:
    - name: people-personId-features-applications
      path: /people/{personId}/features/applications
      operations:
      - name: modifyapersonsapplicationservicessettings
        method: PUT
        description: Modify a person's Application Services 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: 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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-bargeIn
      path: /people/{personId}/features/bargeIn
      operations:
      - name: readbargeinsettingsforaperson
        method: GET
        description: Read Barge In Settings for a Person
        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: configurebargeinsettingsforaperson
        method: PUT
        description: Configure Barge In Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-callForwarding
      path: /people/{personId}/features/callForwarding
      operations:
      - name: readforwardingsettingsforaperson
        method: GET
        description: Read Forwarding Settings for a Person
        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: configurecallforwardingsettingsforaperson
        method: PUT
        description: Configure Call Forwarding Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-callRecording
      path: /people/{personId}/features/callRecording
      operations:
      - name: readcallrecordingsettingsforaperson
        method: GET
        description: Read Call Recording Settings for a Person
        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: configurecallrecordingsettingsforaperson
        method: PUT
        description: Configure Call Recording Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-callWaiting
      path: /people/{personId}/features/callWaiting
      operations:
      - name: readcallwaitingsettingsforaperson
        method: GET
        description: Read Call Waiting Settings for a Person
        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: configurecallwaitingsettingsforaperson
        method: PUT
        description: Configure Call Waiting Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-callerId
      path: /people/{personId}/features/callerId
      operations:
      - name: readcalleridsettingsforaperson
        method: GET
        description: Read Caller ID Settings for a Person
        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: configurecalleridsettingsforaperson
        method: PUT
        description: Configure Caller ID Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-callingBehavior
      path: /people/{personId}/features/callingBehavior
      operations:
      - name: readpersonscallingbehavior
        method: GET
        description: Read Person's Calling Behavior
        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: configureapersonscallingbehavior
        method: PUT
        description: Configure a person's Calling Behavior
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-doNotDisturb
      path: /people/{personId}/features/doNotDisturb
      operations:
      - name: readdonotdisturbsettingsforaperson
        method: GET
        description: Read Do Not Disturb Settings for a Person
        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: configuredonotdisturbsettingsforaperson
        method: PUT
        description: Configure Do Not Disturb Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-executiveAssistant
      path: /people/{personId}/features/executiveAssistant
      operations:
      - name: retrieveexecutiveassistantsettingsforaperson
        method: GET
        description: Retrieve Executive Assistant Settings for a Person
        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: modifyexecutiveassistantsettingsforaperson
        method: PUT
        description: Modify Executive Assistant Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-hoteling
      path: /people/{personId}/features/hoteling
      operations:
      - name: readhotelingsettingsforaperson
        method: GET
        description: Read Hoteling Settings for a Person
        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: configurehotelingsettingsforaperson
        method: PUT
        description: Configure Hoteling Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-incomingPermission
      path: /people/{personId}/features/incomingPermission
      operations:
      - name: readincomingpermissionsettingsforaperson
        method: GET
        description: Read Incoming Permission Settings for a Person
        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: configureincomingpermissionsettingsforaperson
        method: PUT
        description: Configure Incoming Permission Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-intercept
      path: /people/{personId}/features/intercept
      operations:
      - name: readcallinterceptsettingsforaperson
        method: GET
        description: Read Call Intercept Settings for a Person
        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: configurecallinterceptsettingsforaperson
        method: PUT
        description: Configure Call Intercept Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-intercept-actions-announcementUpload-invoke
      path: /people/{personId}/features/intercept/actions/announcementUpload/invoke
      operations:
      - name: configurecallinterceptgreetingforaperson
        method: POST
        description: Configure Call Intercept Greeting for a Person
        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: people-personId-features-monitoring
      path: /people/{personId}/features/monitoring
      operations:
      - name: retrieveapersonsmonitoringsettings
        method: GET
        description: Retrieve a person's Monitoring 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: 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: modifyapersonsmonitoringsettings
        method: PUT
        description: Modify a person's Monitoring 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: 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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-numbers
      path: /people/{personId}/features/numbers
      operations:
      - name: getalistofphonenumbersforaperson
        method: GET
        description: Get a List of Phone Numbers for a Person
        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: preferE164Format
          in: query
          type: boolean
          description: Return phone numbers in E.164 format.
    - name: people-personId-features-outgoingPermission
      path: /people/{personId}/features/outgoingPermission
      operations:
      - name: retrieveapersonsoutgoingcallingpermissionssettings
        method: GET
        description: Retrieve a person's Outgoing Calling Permissions 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: 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: modifyapersonsoutgoingcallingpermissionssettings
        method: PUT
        description: Modify a person's Outgoing Calling Permissions 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: 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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-privacy
      path: /people/{personId}/features/privacy
      operations:
      - name: getapersonsprivacysettings
        method: GET
        description: Get a person's Privacy 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: 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: configureapersonsprivacysettings
        method: PUT
        description: Configure a person's Privacy 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: 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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-pushToTalk
      path: /people/{personId}/features/pushToTalk
      operations:
      - name: readpushtotalksettingsforaperson
        method: GET
        description: Read Push-to-Talk Settings for a Person
        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: configurepushtotalksettingsforaperson
        method: PUT
        description: Configure Push-to-Talk Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-reception
      path: /people/{personId}/features/reception
      operations:
      - name: readreceptionistclientsettingsforaperson
        method: GET
        description: Read Receptionist Client Settings for a Person
        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: configurereceptionistclientsettingsforaperson
        method: PUT
        description: Configure Receptionist Client Settings for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-schedules
      path: /people/{personId}/features/schedules
      operations:
      - name: listofschedulesforaperson
        method: GET
        description: List of Schedules for a Person
        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: start
          in: query
          type: number
          description: Specifies the 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: name
          in: query
          type: string
          description: Specifies the case insensitive substring to be matched against the schedule names. The maximum length
            is 40.
        - name: type
          in: query
          type: string
          description: Specifies the schedule event type to be matched on the given type.
      - name: createscheduleforaperson
        method: POST
        description: Create Schedule for a Person
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: people-personId-features-schedules-scheduleType-scheduleId
      path: /people/{personId}/features/schedules/{scheduleType}/{scheduleId}
      operations:
      - name: getascheduledetails
        method: GET
        description: Get a Schedule Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: personId
          in: path
          type: string
          description: Unique identifier for the person.
          required: true
        - name: scheduleType
          in: path
          type: string
          description: Type of schedule, either `businessHours` or `holidays`.
          required: true
        - name: scheduleId
          in: path
          type: string


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