Cisco Webex Call Controls API — Call Controls

naftiko: 1.0.0-alpha2
info:
  label: Cisco Webex Call Controls API — Call Controls
  description: 'Cisco Webex Call Controls API — Call Controls. 11 operations. Lead operation: Cisco Webex List Calls. Self-contained
    Naftiko capability covering one Cisco Webex business surface.'
  tags:
  - Cisco Webex
  - Call Controls
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CISCO_WEBEX_API_KEY: CISCO_WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: call-controls-call-controls
    baseUri: https://webexapis.com/v1
    description: Cisco Webex Call Controls API — Call Controls business capability. Self-contained, no shared references.
    resources:
    - name: telephony-calls
      path: /telephony/calls
      operations:
      - name: listcalls
        method: GET
        description: Cisco Webex List Calls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: telephony-calls-answer
      path: /telephony/calls/answer
      operations:
      - name: answer
        method: POST
        description: Cisco Webex Answer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-dial
      path: /telephony/calls/dial
      operations:
      - name: dial
        method: POST
        description: Cisco Webex Dial
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-hangup
      path: /telephony/calls/hangup
      operations:
      - name: hangup
        method: POST
        description: Cisco Webex Hangup
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-hold
      path: /telephony/calls/hold
      operations:
      - name: hold
        method: POST
        description: Cisco Webex Hold
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-park
      path: /telephony/calls/park
      operations:
      - name: park
        method: POST
        description: Cisco Webex Park
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-reject
      path: /telephony/calls/reject
      operations:
      - name: reject
        method: POST
        description: Cisco Webex Reject
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-resume
      path: /telephony/calls/resume
      operations:
      - name: resume
        method: POST
        description: Cisco Webex Resume
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-retrieve
      path: /telephony/calls/retrieve
      operations:
      - name: retrieve
        method: POST
        description: Cisco Webex Retrieve
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-transfer
      path: /telephony/calls/transfer
      operations:
      - name: transfer
        method: POST
        description: Cisco Webex Transfer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: telephony-calls-callId
      path: /telephony/calls/{callId}
      operations:
      - name: getcalldetails
        method: GET
        description: Cisco Webex Get Call Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: callId
          in: path
          type: string
          description: Unique identifier for the call.
          required: true
    authentication:
      type: bearer
      token: '{{env.CISCO_WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: call-controls-call-controls-rest
    port: 8080
    description: REST adapter for Cisco Webex Call Controls API — Call Controls. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/telephony/calls
      name: telephony-calls
      description: REST surface for telephony-calls.
      operations:
      - method: GET
        name: listcalls
        description: Cisco Webex List Calls
        call: call-controls-call-controls.listcalls
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/answer
      name: telephony-calls-answer
      description: REST surface for telephony-calls-answer.
      operations:
      - method: POST
        name: answer
        description: Cisco Webex Answer
        call: call-controls-call-controls.answer
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/dial
      name: telephony-calls-dial
      description: REST surface for telephony-calls-dial.
      operations:
      - method: POST
        name: dial
        description: Cisco Webex Dial
        call: call-controls-call-controls.dial
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/hangup
      name: telephony-calls-hangup
      description: REST surface for telephony-calls-hangup.
      operations:
      - method: POST
        name: hangup
        description: Cisco Webex Hangup
        call: call-controls-call-controls.hangup
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/hold
      name: telephony-calls-hold
      description: REST surface for telephony-calls-hold.
      operations:
      - method: POST
        name: hold
        description: Cisco Webex Hold
        call: call-controls-call-controls.hold
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/park
      name: telephony-calls-park
      description: REST surface for telephony-calls-park.
      operations:
      - method: POST
        name: park
        description: Cisco Webex Park
        call: call-controls-call-controls.park
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/reject
      name: telephony-calls-reject
      description: REST surface for telephony-calls-reject.
      operations:
      - method: POST
        name: reject
        description: Cisco Webex Reject
        call: call-controls-call-controls.reject
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/resume
      name: telephony-calls-resume
      description: REST surface for telephony-calls-resume.
      operations:
      - method: POST
        name: resume
        description: Cisco Webex Resume
        call: call-controls-call-controls.resume
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/retrieve
      name: telephony-calls-retrieve
      description: REST surface for telephony-calls-retrieve.
      operations:
      - method: POST
        name: retrieve
        description: Cisco Webex Retrieve
        call: call-controls-call-controls.retrieve
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/transfer
      name: telephony-calls-transfer
      description: REST surface for telephony-calls-transfer.
      operations:
      - method: POST
        name: transfer
        description: Cisco Webex Transfer
        call: call-controls-call-controls.transfer
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/telephony/calls/{callid}
      name: telephony-calls-callid
      description: REST surface for telephony-calls-callId.
      operations:
      - method: GET
        name: getcalldetails
        description: Cisco Webex Get Call Details
        call: call-controls-call-controls.getcalldetails
        with:
          callId: rest.callId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: call-controls-call-controls-mcp
    port: 9090
    transport: http
    description: MCP adapter for Cisco Webex Call Controls API — Call Controls. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: cisco-webex-list-calls
      description: Cisco Webex List Calls
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: call-controls-call-controls.listcalls
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-answer
      description: Cisco Webex Answer
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.answer
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-dial
      description: Cisco Webex Dial
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.dial
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-hangup
      description: Cisco Webex Hangup
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.hangup
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-hold
      description: Cisco Webex Hold
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.hold
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-park
      description: Cisco Webex Park
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.park
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-reject
      description: Cisco Webex Reject
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.reject
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-resume
      description: Cisco Webex Resume
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.resume
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-retrieve
      description: Cisco Webex Retrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: call-controls-call-controls.retrieve
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-transfer
      description: Cisco Webex Transfer
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: call-controls-call-controls.transfer
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cisco-webex-get-call-details
      description: Cisco Webex Get Call Details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: call-controls-call-controls.getcalldetails
      with:
        callId: tools.callId
      outputParameters:
      - type: object
        mapping: $.