Webex Cloud Calling — Caller Reputation Provider

naftiko: 1.0.0-alpha2
info:
  label: Webex Cloud Calling — Caller Reputation Provider
  description: 'Webex Cloud Calling — Caller Reputation Provider. 5 operations. Lead operation: Get Caller Reputation Provider
    Service Settings. Self-contained Naftiko capability covering one Webex business surface.'
  tags:
  - Webex
  - Caller Reputation Provider
  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-caller-reputation-provider
    baseUri: ''
    description: Webex Cloud Calling — Caller Reputation Provider business capability. Self-contained, no shared references.
    resources:
    - name: telephony-config-serviceSettings-callerReputationProvider
      path: /telephony/config/serviceSettings/callerReputationProvider
      operations:
      - name: getcallerreputationprovidersettings
        method: GET
        description: Get Caller Reputation Provider Service Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: query
          type: string
          description: Unique identifier for the organization.
      - name: updatecallerreputationprovidersettings
        method: PUT
        description: Update Caller Reputation Provider Service Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: query
          type: string
          description: Unique identifier for the organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-config-serviceSettings-callerReputationProvider-actions-unlock-invoke
      path: /telephony/config/serviceSettings/callerReputationProvider/actions/unlock/invoke
      operations:
      - name: unlockcallerreputationprovider
        method: POST
        description: Unlock Caller Reputation Provider
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: query
          type: string
          description: Unique identifier for the organization.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-config-serviceSettings-callerReputationProvider-providers
      path: /telephony/config/serviceSettings/callerReputationProvider/providers
      operations:
      - name: getcallerreputationproviderproviders
        method: GET
        description: Get Caller Reputation Provider Providers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: query
          type: string
          description: Unique identifier for the organization.
    - name: telephony-config-serviceSettings-callerReputationProvider-status
      path: /telephony/config/serviceSettings/callerReputationProvider/status
      operations:
      - name: getcallerreputationproviderstatus
        method: GET
        description: Get Caller Reputation Provider Status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: organizationId
          in: query
          type: string
          description: Unique identifier for the organization.
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: cloud-calling-caller-reputation-provider-rest
    port: 8080
    description: REST adapter for Webex Cloud Calling — Caller Reputation Provider. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/telephony/config/servicesettings/callerreputationprovider
      name: telephony-config-servicesettings-callerreputationprovider
      description: REST surface for telephony-config-serviceSettings-callerReputationProvider.
      operations:
      - method: GET
        name: getcallerreputationprovidersettings
        description: Get Caller Reputation Provider Service Settings
        call: cloud-calling-caller-reputation-provider.getcallerreputationprovidersettings
        with:
          organizationId: rest.organizationId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatecallerreputationprovidersettings
        description: Update Caller Reputation Provider Service Settings
        call: cloud-calling-caller-reputation-provider.updatecallerreputationprovidersettings
        with:
          organizationId: rest.organizationId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/servicesettings/callerreputationprovider/actions/unlock/invoke
      name: telephony-config-servicesettings-callerreputationprovider-actions-unlock-invoke
      description: REST surface for telephony-config-serviceSettings-callerReputationProvider-actions-unlock-invoke.
      operations:
      - method: POST
        name: unlockcallerreputationprovider
        description: Unlock Caller Reputation Provider
        call: cloud-calling-caller-reputation-provider.unlockcallerreputationprovider
        with:
          organizationId: rest.organizationId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/servicesettings/callerreputationprovider/providers
      name: telephony-config-servicesettings-callerreputationprovider-providers
      description: REST surface for telephony-config-serviceSettings-callerReputationProvider-providers.
      operations:
      - method: GET
        name: getcallerreputationproviderproviders
        description: Get Caller Reputation Provider Providers
        call: cloud-calling-caller-reputation-provider.getcallerreputationproviderproviders
        with:
          organizationId: rest.organizationId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/config/servicesettings/callerreputationprovider/status
      name: telephony-config-servicesettings-callerreputationprovider-status
      description: REST surface for telephony-config-serviceSettings-callerReputationProvider-status.
      operations:
      - method: GET
        name: getcallerreputationproviderstatus
        description: Get Caller Reputation Provider Status
        call: cloud-calling-caller-reputation-provider.getcallerreputationproviderstatus
        with:
          organizationId: rest.organizationId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloud-calling-caller-reputation-provider-mcp
    port: 9090
    transport: http
    description: MCP adapter for Webex Cloud Calling — Caller Reputation Provider. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: get-caller-reputation-provider-service
      description: Get Caller Reputation Provider Service Settings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-caller-reputation-provider.getcallerreputationprovidersettings
      with:
        organizationId: tools.organizationId
      outputParameters:
      - type: object
        mapping: $.
    - name: update-caller-reputation-provider-service
      description: Update Caller Reputation Provider Service Settings
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: cloud-calling-caller-reputation-provider.updatecallerreputationprovidersettings
      with:
        organizationId: tools.organizationId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: unlock-caller-reputation-provider
      description: Unlock Caller Reputation Provider
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-calling-caller-reputation-provider.unlockcallerreputationprovider
      with:
        organizationId: tools.organizationId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-caller-reputation-provider-providers
      description: Get Caller Reputation Provider Providers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-caller-reputation-provider.getcallerreputationproviderproviders
      with:
        organizationId: tools.organizationId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-caller-reputation-provider-status
      description: Get Caller Reputation Provider Status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-calling-caller-reputation-provider.getcallerreputationproviderstatus
      with:
        organizationId: tools.organizationId
      outputParameters:
      - type: object
        mapping: $.