naftiko: 1.0.0-alpha2 info: label: 'Webex Cloud Calling — Location Call Settings: Call Handling' description: 'Webex Cloud Calling — Location Call Settings: Call Handling. 19 operations. Lead operation: Generate example password for Location. Self-contained Naftiko capability covering one Webex business surface.' tags: - Webex - 'Location Call Settings: Call Handling' 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-location-call-settings-call-handling baseUri: '' description: 'Webex Cloud Calling — Location Call Settings: Call Handling business capability. Self-contained, no shared references.' resources: - name: telephony-config-locations-locationId-actions-generatePassword-invoke path: /telephony/config/locations/{locationId}/actions/generatePassword/invoke operations: - name: generateexamplepasswordforlocation method: POST description: Generate example password for Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Location for which example password has to be generated. required: true - name: orgId in: query type: string description: Organization to which the location belongs. - name: body in: body type: object description: Request body (JSON). required: false - name: telephony-config-locations-locationId-intercept path: /telephony/config/locations/{locationId}/intercept operations: - name: getlocationintercept method: GET description: Get Location Intercept outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Retrieve intercept details for this location. required: true - name: orgId in: query type: string description: Retrieve intercept location details for a customer location. - name: putlocationintercept method: PUT description: Put Location Intercept outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Modifies the intercept details for this location. required: true - name: orgId in: query type: string description: Modifies the intercept location details for a customer location. - name: body in: body type: object description: Request body (JSON). required: false - name: telephony-config-locations-locationId-internalDialing path: /telephony/config/locations/{locationId}/internalDialing operations: - name: readtheinternaldialingconfigurationforalocation method: GET description: Read the Internal Dialing configuration for a location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: location for which internal calling configuration is being requested required: true - name: orgId in: query type: string description: List route identities for this organization. - name: modifytheinternaldialingconfigurationforalocation method: PUT description: Modify the Internal Dialing configuration for a location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: location for which internal calling configuration is being requested required: true - name: orgId in: query type: string description: List route identities for this organization. - name: body in: body type: object description: Request body (JSON). required: false - name: telephony-config-locations-locationId-outgoingPermission path: /telephony/config/locations/{locationId}/outgoingPermission operations: - name: getlocationoutgoingpermission method: GET description: Get Location Outgoing Permission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Retrieve outgoing call settings for this location. required: true - name: orgId in: query type: string description: Retrieve outgoing call settings for this organization. - name: updatelocationoutgoingpermission method: PUT description: Update Location Outgoing Permission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Update outgoing call settings for this location. required: true - name: orgId in: query type: string description: Update outgoing call settings for this organization. - name: body in: body type: object description: Request body (JSON). required: false - name: telephony-config-locations-locationId-outgoingPermission-accessCodes path: /telephony/config/locations/{locationId}/outgoingPermission/accessCodes operations: - name: getoutgoingpermissionlocationaccesscode method: GET description: Get Outgoing Permission Location Access Code outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Retrieve access codes details for this location. required: true - name: orgId in: query type: string description: Retrieve access codes details for a customer location. - name: createoutgoingpermissionanewaccesscodeforacustomerlocation method: POST description: Create Outgoing Permission a new access code for a customer location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Add new access code for this location. required: true - name: orgId in: query type: string description: Add new access code for this organization. - name: body in: body type: object description: Request body (JSON). required: false - name: deleteoutgoingpermissionaccesscodelocation method: PUT description: Delete Outgoing Permission Access Code Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Deletes the access code details for this location. required: true - name: orgId in: query type: string description: Deletes the access code details for a customer location. - name: body in: body type: object description: Request body (JSON). required: false - name: deletealloutgoingpermissionaccesscodeforalocation method: DELETE description: Delete all Outgoing Permission Access Code for a Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Deletes all the access codes for this location. required: true - name: orgId in: query type: string description: Deletes the access codes for a customer location. - name: telephony-config-locations-locationId-outgoingPermission-autoTransferNumbers path: /telephony/config/locations/{locationId}/outgoingPermission/autoTransferNumbers operations: - name: getoutgoingpermissionautotransfernumber method: GET description: Get Outgoing Permission Auto Transfer Number outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Retrieve auto transfer number for this location. required: true - name: orgId in: query type: string description: Retrieve auto transfer number for this organization. - name: putoutgoingpermissionautotransfernumber method: PUT description: Put Outgoing Permission Auto Transfer Number outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Updating auto transfer number for this location. required: true - name: orgId in: query type: string description: Updating auto transfer number for this organization. - name: body in: body type: object description: Request body (JSON). required: false - name: telephony-config-locations-locationId-outgoingPermission-digitPatterns path: /telephony/config/locations/{locationId}/outgoingPermission/digitPatterns operations: - name: getoutgoingpermissiondigitpatternforalocation method: GET description: Get Outgoing Permission Digit Pattern for a Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Retrieve the digit patterns for this location. required: true - name: orgId in: query type: string description: Retrieve the digit patterns for this organization. - name: createoutgoingpermissionanewdigitpatternforalocation method: POST description: Create Outgoing Permission a new Digit Pattern for a location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Add a new digit pattern for this location. required: true - name: orgId in: query type: string description: Add a new digit pattern for this organization. - name: body in: body type: object description: Request body (JSON). required: false - name: deletealloutgoingpermissiondigitpatternsforalocation method: DELETE description: Delete all Outgoing Permission Digit Patterns for a Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Delete the digit patterns for this location. required: true - name: orgId in: query type: string description: Delete the digit patterns for this organization. - name: telephony-config-locations-locationId-outgoingPermission-digitPatterns-digitPatt path: /telephony/config/locations/{locationId}/outgoingPermission/digitPatterns/{digitPatternId} operations: - name: getdetailsforaoutgoingpermissiondigitpatternforalocation method: GET description: Get Details for a Outgoing Permission Digit Pattern for a Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Retrieve the digit pattern details for this location. required: true - name: digitPatternId in: path type: string description: Retrieve the digit pattern with the matching ID. required: true - name: orgId in: query type: string description: Retrieve the digit pattern details for this organization. - name: updateaoutgoingpermissiondigitpatternforalocation method: PUT description: Update a Outgoing Permission Digit Pattern for a Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Update the digit pattern for this location. required: true - name: digitPatternId in: path type: string description: Update the digit pattern with the matching ID. required: true - name: orgId in: query type: string description: Update the digit pattern for this organization. - name: body in: body type: object description: Request body (JSON). required: false - name: deleteaoutgoingpermissiondigitpatternforalocation method: DELETE description: Delete a Outgoing Permission Digit Pattern for a Location outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: locationId in: path type: string description: Delete the digit pattern for this location. required: true - name: digitPatternId in: path type: string description: Delete the digit pattern with the matching ID. required: true - name: orgId in: query type: string description: Delete the digit pattern for this organization. authentication: type: bearer token: '{{env.WEBEX_API_KEY}}' exposes: - type: rest namespace: cloud-calling-location-call-settings-call-handling-rest port: 8080 description: 'REST adapter for Webex Cloud Calling — Location Call Settings: Call Handling. One Spectral-compliant resource per consumed operation, prefixed with /v1.' resources: - path: /v1/telephony/config/locations/{locationid}/actions/generatepassword/invoke name: telephony-config-locations-locationid-actions-generatepassword-invoke description: REST surface for telephony-config-locations-locationId-actions-generatePassword-invoke. operations: - method: POST name: generateexamplepasswordforlocation description: Generate example password for Location call: cloud-calling-location-call-settings-call-handling.generateexamplepasswordforlocation with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - path: /v1/telephony/config/locations/{locationid}/intercept name: telephony-config-locations-locationid-intercept description: REST surface for telephony-config-locations-locationId-intercept. operations: - method: GET name: getlocationintercept description: Get Location Intercept call: cloud-calling-location-call-settings-call-handling.getlocationintercept with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - method: PUT name: putlocationintercept description: Put Location Intercept call: cloud-calling-location-call-settings-call-handling.putlocationintercept with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - path: /v1/telephony/config/locations/{locationid}/internaldialing name: telephony-config-locations-locationid-internaldialing description: REST surface for telephony-config-locations-locationId-internalDialing. operations: - method: GET name: readtheinternaldialingconfigurationforalocation description: Read the Internal Dialing configuration for a location call: cloud-calling-location-call-settings-call-handling.readtheinternaldialingconfigurationforalocation with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - method: PUT name: modifytheinternaldialingconfigurationforalocation description: Modify the Internal Dialing configuration for a location call: cloud-calling-location-call-settings-call-handling.modifytheinternaldialingconfigurationforalocation with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - path: /v1/telephony/config/locations/{locationid}/outgoingpermission name: telephony-config-locations-locationid-outgoingpermission description: REST surface for telephony-config-locations-locationId-outgoingPermission. operations: - method: GET name: getlocationoutgoingpermission description: Get Location Outgoing Permission call: cloud-calling-location-call-settings-call-handling.getlocationoutgoingpermission with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - method: PUT name: updatelocationoutgoingpermission description: Update Location Outgoing Permission call: cloud-calling-location-call-settings-call-handling.updatelocationoutgoingpermission with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - path: /v1/telephony/config/locations/{locationid}/outgoingpermission/accesscodes name: telephony-config-locations-locationid-outgoingpermission-accesscodes description: REST surface for telephony-config-locations-locationId-outgoingPermission-accessCodes. operations: - method: GET name: getoutgoingpermissionlocationaccesscode description: Get Outgoing Permission Location Access Code call: cloud-calling-location-call-settings-call-handling.getoutgoingpermissionlocationaccesscode with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - method: POST name: createoutgoingpermissionanewaccesscodeforacustomerlocation description: Create Outgoing Permission a new access code for a customer location call: cloud-calling-location-call-settings-call-handling.createoutgoingpermissionanewaccesscodeforacustomerlocation with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: deleteoutgoingpermissionaccesscodelocation description: Delete Outgoing Permission Access Code Location call: cloud-calling-location-call-settings-call-handling.deleteoutgoingpermissionaccesscodelocation with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deletealloutgoingpermissionaccesscodeforalocation description: Delete all Outgoing Permission Access Code for a Location call: cloud-calling-location-call-settings-call-handling.deletealloutgoingpermissionaccesscodeforalocation with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - path: /v1/telephony/config/locations/{locationid}/outgoingpermission/autotransfernumbers name: telephony-config-locations-locationid-outgoingpermission-autotransfernumbers description: REST surface for telephony-config-locations-locationId-outgoingPermission-autoTransferNumbers. operations: - method: GET name: getoutgoingpermissionautotransfernumber description: Get Outgoing Permission Auto Transfer Number call: cloud-calling-location-call-settings-call-handling.getoutgoingpermissionautotransfernumber with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - method: PUT name: putoutgoingpermissionautotransfernumber description: Put Outgoing Permission Auto Transfer Number call: cloud-calling-location-call-settings-call-handling.putoutgoingpermissionautotransfernumber with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - path: /v1/telephony/config/locations/{locationid}/outgoingpermission/digitpatterns name: telephony-config-locations-locationid-outgoingpermission-digitpatterns description: REST surface for telephony-config-locations-locationId-outgoingPermission-digitPatterns. operations: - method: GET name: getoutgoingpermissiondigitpatternforalocation description: Get Outgoing Permission Digit Pattern for a Location call: cloud-calling-location-call-settings-call-handling.getoutgoingpermissiondigitpatternforalocation with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - method: POST name: createoutgoingpermissionanewdigitpatternforalocation description: Create Outgoing Permission a new Digit Pattern for a location call: cloud-calling-location-call-settings-call-handling.createoutgoingpermissionanewdigitpatternforalocation with: locationId: rest.locationId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deletealloutgoingpermissiondigitpatternsforalocation description: Delete all Outgoing Permission Digit Patterns for a Location call: cloud-calling-location-call-settings-call-handling.deletealloutgoingpermissiondigitpatternsforalocation with: locationId: rest.locationId orgId: rest.orgId outputParameters: - type: object mapping: $. - path: /v1/telephony/config/locations/{locationid}/outgoingpermission/digitpatterns/{digitpatternid} name: telephony-config-locations-locationid-outgoingpermission-digitpatterns-digitpatt description: REST surface for telephony-config-locations-locationId-outgoingPermission-digitPatterns-digitPatt. operations: - method: GET name: getdetailsforaoutgoingpermissiondigitpatternforalocation description: Get Details for a Outgoing Permission Digit Pattern for a Location call: cloud-calling-location-call-settings-call-handling.getdetailsforaoutgoingpermissiondigitpatternforalocation with: locationId: rest.locationId digitPatternId: rest.digitPatternId orgId: rest.orgId outputParameters: - type: object mapping: $. - method: PUT name: updateaoutgoingpermissiondigitpatternforalocation description: Update a Outgoing Permission Digit Pattern for a Location call: cloud-calling-location-call-settings-call-handling.updateaoutgoingpermissiondigitpatternforalocation with: locationId: rest.locationId digitPatternId: rest.digitPatternId orgId: rest.orgId body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteaoutgoingpermissiondigitpatternforalocation description: Delete a Outgoing Permission Digit Pattern for a Location call: cloud-calling-location-call-settings-call-handling.deleteaoutgoingpermissiondigitpatternforalocation with: locationId: rest.locationId digitPatternId: rest.digitPatternId orgId: rest.orgId outputParameters: - type: object mapping: $. - type: mcp namespace: cloud-calling-location-call-settings-call-handling-mcp port: 9090 transport: http description: 'MCP adapter for Webex Cloud Calling — Location Call Settings: Call Handling. One tool per consumed operation, routed inline through this capability''s consumes block.' tools: - name: generate-example-password-location description: Generate example password for Location hints: readOnly: false destructive: false idempotent: false call: cloud-calling-location-call-settings-call-handling.generateexamplepasswordforlocation with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: get-location-intercept description: Get Location Intercept hints: readOnly: true destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.getlocationintercept with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: put-location-intercept description: Put Location Intercept hints: readOnly: false destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.putlocationintercept with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: read-internal-dialing-configuration-location description: Read the Internal Dialing configuration for a location hints: readOnly: true destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.readtheinternaldialingconfigurationforalocation with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: modify-internal-dialing-configuration-location description: Modify the Internal Dialing configuration for a location hints: readOnly: false destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.modifytheinternaldialingconfigurationforalocation with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: get-location-outgoing-permission description: Get Location Outgoing Permission hints: readOnly: true destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.getlocationoutgoingpermission with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: update-location-outgoing-permission description: Update Location Outgoing Permission hints: readOnly: false destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.updatelocationoutgoingpermission with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: get-outgoing-permission-location-access description: Get Outgoing Permission Location Access Code hints: readOnly: true destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.getoutgoingpermissionlocationaccesscode with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: create-outgoing-permission-new-access description: Create Outgoing Permission a new access code for a customer location hints: readOnly: false destructive: false idempotent: false call: cloud-calling-location-call-settings-call-handling.createoutgoingpermissionanewaccesscodeforacustomerlocation with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: delete-outgoing-permission-access-code description: Delete Outgoing Permission Access Code Location hints: readOnly: false destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.deleteoutgoingpermissionaccesscodelocation with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: delete-all-outgoing-permission-access description: Delete all Outgoing Permission Access Code for a Location hints: readOnly: false destructive: true idempotent: true call: cloud-calling-location-call-settings-call-handling.deletealloutgoingpermissionaccesscodeforalocation with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: get-outgoing-permission-auto-transfer description: Get Outgoing Permission Auto Transfer Number hints: readOnly: true destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.getoutgoingpermissionautotransfernumber with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: put-outgoing-permission-auto-transfer description: Put Outgoing Permission Auto Transfer Number hints: readOnly: false destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.putoutgoingpermissionautotransfernumber with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: get-outgoing-permission-digit-pattern description: Get Outgoing Permission Digit Pattern for a Location hints: readOnly: true destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.getoutgoingpermissiondigitpatternforalocation with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: create-outgoing-permission-new-digit description: Create Outgoing Permission a new Digit Pattern for a location hints: readOnly: false destructive: false idempotent: false call: cloud-calling-location-call-settings-call-handling.createoutgoingpermissionanewdigitpatternforalocation with: locationId: tools.locationId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: delete-all-outgoing-permission-digit description: Delete all Outgoing Permission Digit Patterns for a Location hints: readOnly: false destructive: true idempotent: true call: cloud-calling-location-call-settings-call-handling.deletealloutgoingpermissiondigitpatternsforalocation with: locationId: tools.locationId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: get-details-outgoing-permission-digit description: Get Details for a Outgoing Permission Digit Pattern for a Location hints: readOnly: true destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.getdetailsforaoutgoingpermissiondigitpatternforalocation with: locationId: tools.locationId digitPatternId: tools.digitPatternId orgId: tools.orgId outputParameters: - type: object mapping: $. - name: update-outgoing-permission-digit-pattern description: Update a Outgoing Permission Digit Pattern for a Location hints: readOnly: false destructive: false idempotent: true call: cloud-calling-location-call-settings-call-handling.updateaoutgoingpermissiondigitpatternforalocation with: locationId: tools.locationId digitPatternId: tools.digitPatternId orgId: tools.orgId body: tools.body outputParameters: - type: object mapping: $. - name: delete-outgoing-permission-digit-pattern description: Delete a Outgoing Permission Digit Pattern for a Location hints: readOnly: false destructive: true idempotent: true call: cloud-calling-location-call-settings-call-handling.deleteaoutgoingpermissiondigitpatternforalocation with: locationId: tools.locationId digitPatternId: tools.digitPatternId orgId: tools.orgId outputParameters: - type: object mapping: $.