Webex Cloud Calling — Features: Auto Attendant. 17 operations. Lead operation: Read the List of Auto Attendants. Self-contained Naftiko capability covering one Webex business surface.
naftiko: 1.0.0-alpha2
info:
label: 'Webex Cloud Calling — Features: Auto Attendant'
description: 'Webex Cloud Calling — Features: Auto Attendant. 17 operations. Lead operation: Read the List of Auto Attendants.
Self-contained Naftiko capability covering one Webex business surface.'
tags:
- Webex
- 'Features: Auto Attendant'
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-features-auto-attendant
baseUri: ''
description: 'Webex Cloud Calling — Features: Auto Attendant business capability. Self-contained, no shared references.'
resources:
- name: telephony-config-autoAttendants
path: /telephony/config/autoAttendants
operations:
- name: listautoattendants
method: GET
description: Read the List of Auto Attendants
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: orgId
in: query
type: string
description: List auto attendants for this organization.
- name: locationId
in: query
type: string
description: Return the list of auto attendants for this location.
- 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 auto attendants with the matching name.
- name: phoneNumber
in: query
type: string
description: Only return auto attendants with the matching phone number.
- name: telephony-config-locations-locationId-autoAttendants
path: /telephony/config/locations/{locationId}/autoAttendants
operations:
- name: createautoattendant
method: POST
description: Create an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Create the auto attendant for this location.
required: true
- name: orgId
in: query
type: string
description: Create the auto attendant for this organization.
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: telephony-config-locations-locationId-autoAttendants-alternate-availableNumbers
path: /telephony/config/locations/{locationId}/autoAttendants/alternate/availableNumbers
operations:
- name: getautoattendantalternateavailablephonenumbers
method: GET
description: Get Auto Attendant Alternate Available Phone Numbers
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Return the list of phone numbers for this location within the given organization. The maximum length
is 36.
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: telephony-config-locations-locationId-autoAttendants-availableNumbers
path: /telephony/config/locations/{locationId}/autoAttendants/availableNumbers
operations:
- name: getautoattendantprimaryavailablephonenumbers
method: GET
description: Get Auto Attendant Primary Available Phone Numbers
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Return the list of phone numbers for this location within the given organization. The maximum length
is 36.
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: telephony-config-locations-locationId-autoAttendants-callForwarding-availableNum
path: /telephony/config/locations/{locationId}/autoAttendants/callForwarding/availableNumbers
operations:
- name: getautoattendantcallforwardavailablephonenumbers
method: GET
description: Get Auto Attendant Call Forward Available Phone Numbers
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Return the list of phone numbers for this location within the given organization. The maximum length
is 36.
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-locations-locationId-autoAttendants-autoAttendantId
path: /telephony/config/locations/{locationId}/autoAttendants/{autoAttendantId}
operations:
- name: getautoattendant
method: GET
description: Get Details for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Retrieve an auto attendant details in this location.
required: true
- name: autoAttendantId
in: path
type: string
description: Retrieve the auto attendant with the matching ID.
required: true
- name: orgId
in: query
type: string
description: Retrieve auto attendant details from this organization.
- name: updateautoattendant
method: PUT
description: Update an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which this auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Update an auto attendant with the matching ID.
required: true
- name: orgId
in: query
type: string
description: Update an auto attendant from this organization.
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: deleteautoattendant
method: DELETE
description: Delete an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location from which to delete an auto attendant.
required: true
- name: autoAttendantId
in: path
type: string
description: Delete the auto attendant with the matching ID.
required: true
- name: orgId
in: query
type: string
description: Delete the auto attendant from this organization.
- name: telephony-config-locations-locationId-autoAttendants-autoAttendantId-announcemen
path: /telephony/config/locations/{locationId}/autoAttendants/{autoAttendantId}/announcements
operations:
- name: listautoattendantannouncementfiles
method: GET
description: Read the List of Auto Attendant Announcement Files
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which this auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Retrieve announcement files for the auto attendant with this identifier.
required: true
- name: orgId
in: query
type: string
description: Retrieve announcement files for a auto attendant from this organization.
- name: telephony-config-locations-locationId-autoAttendants-autoAttendantId-announcemen
path: /telephony/config/locations/{locationId}/autoAttendants/{autoAttendantId}/announcements/{fileName}
operations:
- name: deleteautoattendantannouncementfile
method: DELETE
description: Delete a Auto Attendant Announcement File
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Delete an announcement for a auto attendant in this location.
required: true
- name: autoAttendantId
in: path
type: string
description: Delete an announcement for the auto attendant with this identifier.
required: true
- name: fileName
in: path
type: string
required: true
- name: orgId
in: query
type: string
description: Delete auto attendant announcement from this organization.
- name: telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward
path: /telephony/config/locations/{locationId}/autoAttendants/{autoAttendantId}/callForwarding
operations:
- name: getautoattendantcallforwardingsettings
method: GET
description: Get Call Forwarding Settings for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which this auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Retrieve the call forwarding settings for this auto attendant.
required: true
- name: orgId
in: query
type: string
description: Retrieve auto attendant forwarding settings from this organization.
- name: updateautoattendantcallforwardingsettings
method: PUT
description: Update Call Forwarding Settings for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which this auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Update call forwarding settings for this auto attendant.
required: true
- name: orgId
in: query
type: string
description: Update auto attendant forwarding settings from this organization.
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward
path: /telephony/config/locations/{locationId}/autoAttendants/{autoAttendantId}/callForwarding/actions/switchMode/invoke
operations:
- name: switchautoattendantcallforwardingmode
method: POST
description: Switch Mode for Call Forwarding Settings for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: '`Location` in which this `auto attendant` exists.'
required: true
- name: autoAttendantId
in: path
type: string
description: Switch operating mode to normal operations for this `auto attendant`.
required: true
- name: orgId
in: query
type: string
description: Switch operating mode as per normal operations for the `auto attendant` from this organization.
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward
path: /telephony/config/locations/{locationId}/autoAttendants/{autoAttendantId}/callForwarding/selectiveRules
operations:
- name: createautoattendantselectivecallforwardingrule
method: POST
description: Create a Selective Call Forwarding Rule for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which the auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Create the rule for this auto attendant.
required: true
- name: orgId
in: query
type: string
description: Create the auto attendant rule for this organization.
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward
path: /telephony/config/locations/{locationId}/autoAttendants/{autoAttendantId}/callForwarding/selectiveRules/{ruleId}
operations:
- name: getautoattendantselectivecallforwardingrule
method: GET
description: Get Selective Call Forwarding Rule for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which this auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Retrieve settings for a rule for this auto attendant.
required: true
- name: ruleId
in: path
type: string
description: Auto attendant rule you are retrieving settings for.
required: true
- name: orgId
in: query
type: string
description: Retrieve auto attendant rule settings for this organization.
- name: updateautoattendantselectivecallforwardingrule
method: PUT
description: Update Selective Call Forwarding Rule for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which this auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Update settings for a rule for this auto attendant.
required: true
- name: ruleId
in: path
type: string
description: Auto attendant rule you are updating settings for.
required: true
- name: orgId
in: query
type: string
description: Update auto attendant rule settings for this organization.
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: deleteautoattendantselectivecallforwardingrule
method: DELETE
description: Delete a Selective Call Forwarding Rule for an Auto Attendant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: locationId
in: path
type: string
description: Location in which this auto attendant exists.
required: true
- name: autoAttendantId
in: path
type: string
description: Delete the rule for this auto attendant.
required: true
- name: ruleId
in: path
type: string
description: Auto attendant rule you are deleting.
required: true
- name: orgId
in: query
type: string
description: Delete auto attendant rule from this organization.
authentication:
type: bearer
token: '{{env.WEBEX_API_KEY}}'
exposes:
- type: rest
namespace: cloud-calling-features-auto-attendant-rest
port: 8080
description: 'REST adapter for Webex Cloud Calling — Features: Auto Attendant. One Spectral-compliant resource per consumed
operation, prefixed with /v1.'
resources:
- path: /v1/telephony/config/autoattendants
name: telephony-config-autoattendants
description: REST surface for telephony-config-autoAttendants.
operations:
- method: GET
name: listautoattendants
description: Read the List of Auto Attendants
call: cloud-calling-features-auto-attendant.listautoattendants
with:
orgId: rest.orgId
locationId: rest.locationId
max: rest.max
start: rest.start
name: rest.name
phoneNumber: rest.phoneNumber
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants
name: telephony-config-locations-locationid-autoattendants
description: REST surface for telephony-config-locations-locationId-autoAttendants.
operations:
- method: POST
name: createautoattendant
description: Create an Auto Attendant
call: cloud-calling-features-auto-attendant.createautoattendant
with:
locationId: rest.locationId
orgId: rest.orgId
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/alternate/availablenumbers
name: telephony-config-locations-locationid-autoattendants-alternate-availablenumbers
description: REST surface for telephony-config-locations-locationId-autoAttendants-alternate-availableNumbers.
operations:
- method: GET
name: getautoattendantalternateavailablephonenumbers
description: Get Auto Attendant Alternate Available Phone Numbers
call: cloud-calling-features-auto-attendant.getautoattendantalternateavailablephonenumbers
with:
locationId: rest.locationId
orgId: rest.orgId
max: rest.max
start: rest.start
phoneNumber: rest.phoneNumber
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/availablenumbers
name: telephony-config-locations-locationid-autoattendants-availablenumbers
description: REST surface for telephony-config-locations-locationId-autoAttendants-availableNumbers.
operations:
- method: GET
name: getautoattendantprimaryavailablephonenumbers
description: Get Auto Attendant Primary Available Phone Numbers
call: cloud-calling-features-auto-attendant.getautoattendantprimaryavailablephonenumbers
with:
locationId: rest.locationId
orgId: rest.orgId
max: rest.max
start: rest.start
phoneNumber: rest.phoneNumber
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/callforwarding/availablenumbers
name: telephony-config-locations-locationid-autoattendants-callforwarding-availablenum
description: REST surface for telephony-config-locations-locationId-autoAttendants-callForwarding-availableNum.
operations:
- method: GET
name: getautoattendantcallforwardavailablephonenumbers
description: Get Auto Attendant Call Forward Available Phone Numbers
call: cloud-calling-features-auto-attendant.getautoattendantcallforwardavailablephonenumbers
with:
locationId: rest.locationId
orgId: rest.orgId
max: rest.max
start: rest.start
phoneNumber: rest.phoneNumber
ownerName: rest.ownerName
extension: rest.extension
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/{autoattendantid}
name: telephony-config-locations-locationid-autoattendants-autoattendantid
description: REST surface for telephony-config-locations-locationId-autoAttendants-autoAttendantId.
operations:
- method: GET
name: getautoattendant
description: Get Details for an Auto Attendant
call: cloud-calling-features-auto-attendant.getautoattendant
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
outputParameters:
- type: object
mapping: $.
- method: PUT
name: updateautoattendant
description: Update an Auto Attendant
call: cloud-calling-features-auto-attendant.updateautoattendant
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: DELETE
name: deleteautoattendant
description: Delete an Auto Attendant
call: cloud-calling-features-auto-attendant.deleteautoattendant
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/{autoattendantid}/announcements
name: telephony-config-locations-locationid-autoattendants-autoattendantid-announcemen
description: REST surface for telephony-config-locations-locationId-autoAttendants-autoAttendantId-announcemen.
operations:
- method: GET
name: listautoattendantannouncementfiles
description: Read the List of Auto Attendant Announcement Files
call: cloud-calling-features-auto-attendant.listautoattendantannouncementfiles
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/{autoattendantid}/announcements/{filename}
name: telephony-config-locations-locationid-autoattendants-autoattendantid-announcemen
description: REST surface for telephony-config-locations-locationId-autoAttendants-autoAttendantId-announcemen.
operations:
- method: DELETE
name: deleteautoattendantannouncementfile
description: Delete a Auto Attendant Announcement File
call: cloud-calling-features-auto-attendant.deleteautoattendantannouncementfile
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
fileName: rest.fileName
orgId: rest.orgId
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/{autoattendantid}/callforwarding
name: telephony-config-locations-locationid-autoattendants-autoattendantid-callforward
description: REST surface for telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward.
operations:
- method: GET
name: getautoattendantcallforwardingsettings
description: Get Call Forwarding Settings for an Auto Attendant
call: cloud-calling-features-auto-attendant.getautoattendantcallforwardingsettings
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
outputParameters:
- type: object
mapping: $.
- method: PUT
name: updateautoattendantcallforwardingsettings
description: Update Call Forwarding Settings for an Auto Attendant
call: cloud-calling-features-auto-attendant.updateautoattendantcallforwardingsettings
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/{autoattendantid}/callforwarding/actions/switchmode/invoke
name: telephony-config-locations-locationid-autoattendants-autoattendantid-callforward
description: REST surface for telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward.
operations:
- method: POST
name: switchautoattendantcallforwardingmode
description: Switch Mode for Call Forwarding Settings for an Auto Attendant
call: cloud-calling-features-auto-attendant.switchautoattendantcallforwardingmode
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/{autoattendantid}/callforwarding/selectiverules
name: telephony-config-locations-locationid-autoattendants-autoattendantid-callforward
description: REST surface for telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward.
operations:
- method: POST
name: createautoattendantselectivecallforwardingrule
description: Create a Selective Call Forwarding Rule for an Auto Attendant
call: cloud-calling-features-auto-attendant.createautoattendantselectivecallforwardingrule
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
orgId: rest.orgId
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/telephony/config/locations/{locationid}/autoattendants/{autoattendantid}/callforwarding/selectiverules/{ruleid}
name: telephony-config-locations-locationid-autoattendants-autoattendantid-callforward
description: REST surface for telephony-config-locations-locationId-autoAttendants-autoAttendantId-callForward.
operations:
- method: GET
name: getautoattendantselectivecallforwardingrule
description: Get Selective Call Forwarding Rule for an Auto Attendant
call: cloud-calling-features-auto-attendant.getautoattendantselectivecallforwardingrule
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
ruleId: rest.ruleId
orgId: rest.orgId
outputParameters:
- type: object
mapping: $.
- method: PUT
name: updateautoattendantselectivecallforwardingrule
description: Update Selective Call Forwarding Rule for an Auto Attendant
call: cloud-calling-features-auto-attendant.updateautoattendantselectivecallforwardingrule
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
ruleId: rest.ruleId
orgId: rest.orgId
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: DELETE
name: deleteautoattendantselectivecallforwardingrule
description: Delete a Selective Call Forwarding Rule for an Auto Attendant
call: cloud-calling-features-auto-attendant.deleteautoattendantselectivecallforwardingrule
with:
locationId: rest.locationId
autoAttendantId: rest.autoAttendantId
ruleId: rest.ruleId
orgId: rest.orgId
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: cloud-calling-features-auto-attendant-mcp
port: 9090
transport: http
description: 'MCP adapter for Webex Cloud Calling — Features: Auto Attendant. One tool per consumed operation, routed
inline through this capability''s consumes block.'
tools:
- name: read-list-auto-attendants
description: Read the List of Auto Attendants
hints:
readOnly: true
destructive: false
idempotent: true
call: cloud-calling-features-auto-attendant.listautoattendants
with:
orgId: tools.orgId
locationId: tools.locationId
max: tools.max
start: tools.start
name: tools.name
phoneNumber: tools.phoneNumber
outputParameters:
- type: object
mapping: $.
- name: create-auto-attendant
description: Create an Auto Attendant
hints:
readOnly: false
destructive: false
idempotent: false
call: cloud-calling-features-auto-attendant.createautoattendant
with:
locationId: tools.locationId
orgId: tools.orgId
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: get-auto-attendant-alternate-available
description: Get Auto Attendant Alternate Available Phone Numbers
hints:
readOnly: true
destructive: false
idempotent: true
call: cloud-calling-features-auto-attendant.getau
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/webex/refs/heads/main/capabilities/cloud-calling-features-auto-attendant.yaml