naftiko: 1.0.0-alpha2
info:
  label: Telnyx API — Call Commands
  description: 'Telnyx API — Call Commands. 39 operations. Lead operation: Dial. Self-contained Naftiko capability covering
    one Telnyx business surface.'
  tags:
  - Telnyx
  - Call Commands
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TELNYX_API_KEY: TELNYX_API_KEY
capability:
  consumes:
  - type: http
    namespace: telnyx-call-commands
    baseUri: https://api.telnyx.com/v2
    description: Telnyx API — Call Commands business capability. Self-contained, no shared references.
    resources:
    - name: calls
      path: /calls
      operations:
      - name: dialcall
        method: POST
        description: Dial
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-ai_assistant_add_messages
      path: /calls/{call_control_id}/actions/ai_assistant_add_messages
      operations:
      - name: calladdmessagestoaiassistant
        method: POST
        description: Add messages to AI Assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-ai_assistant_join
      path: /calls/{call_control_id}/actions/ai_assistant_join
      operations:
      - name: calljoinaiassistant
        method: POST
        description: Join AI Assistant Conversation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-ai_assistant_start
      path: /calls/{call_control_id}/actions/ai_assistant_start
      operations:
      - name: callstartaiassistant
        method: POST
        description: Start AI Assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-ai_assistant_stop
      path: /calls/{call_control_id}/actions/ai_assistant_stop
      operations:
      - name: callstopaiassistant
        method: POST
        description: Stop AI Assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-answer
      path: /calls/{call_control_id}/actions/answer
      operations:
      - name: answercall
        method: POST
        description: Answer call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-bridge
      path: /calls/{call_control_id}/actions/bridge
      operations:
      - name: bridgecall
        method: POST
        description: Bridge calls
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-client_state_update
      path: /calls/{call_control_id}/actions/client_state_update
      operations:
      - name: updateclientstate
        method: PUT
        description: Update client state
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-enqueue
      path: /calls/{call_control_id}/actions/enqueue
      operations:
      - name: enqueuecall
        method: POST
        description: Enqueue call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-fork_start
      path: /calls/{call_control_id}/actions/fork_start
      operations:
      - name: startcallfork
        method: POST
        description: Forking start
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-fork_stop
      path: /calls/{call_control_id}/actions/fork_stop
      operations:
      - name: stopcallfork
        method: POST
        description: Forking stop
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-gather
      path: /calls/{call_control_id}/actions/gather
      operations:
      - name: gathercall
        method: POST
        description: Gather
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-gather_stop
      path: /calls/{call_control_id}/actions/gather_stop
      operations:
      - name: stopcallgather
        method: POST
        description: Gather stop
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-gather_using_ai
      path: /calls/{call_control_id}/actions/gather_using_ai
      operations:
      - name: callgatherusingai
        method: POST
        description: Gather using AI
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-gather_using_audio
      path: /calls/{call_control_id}/actions/gather_using_audio
      operations:
      - name: gatherusingaudio
        method: POST
        description: Gather using audio
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-gather_using_speak
      path: /calls/{call_control_id}/actions/gather_using_speak
      operations:
      - name: gatherusingspeak
        method: POST
        description: Gather using speak
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-hangup
      path: /calls/{call_control_id}/actions/hangup
      operations:
      - name: hangupcall
        method: POST
        description: Hangup call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-leave_queue
      path: /calls/{call_control_id}/actions/leave_queue
      operations:
      - name: leavequeue
        method: POST
        description: Remove call from a queue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-playback_start
      path: /calls/{call_control_id}/actions/playback_start
      operations:
      - name: startcallplayback
        method: POST
        description: Play audio URL
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-playback_stop
      path: /calls/{call_control_id}/actions/playback_stop
      operations:
      - name: stopcallplayback
        method: POST
        description: Stop audio playback
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-record_pause
      path: /calls/{call_control_id}/actions/record_pause
      operations:
      - name: pausecallrecording
        method: POST
        description: Record pause
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-record_resume
      path: /calls/{call_control_id}/actions/record_resume
      operations:
      - name: resumecallrecording
        method: POST
        description: Record resume
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-record_start
      path: /calls/{call_control_id}/actions/record_start
      operations:
      - name: startcallrecord
        method: POST
        description: Recording start
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-record_stop
      path: /calls/{call_control_id}/actions/record_stop
      operations:
      - name: stopcallrecording
        method: POST
        description: Recording stop
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-refer
      path: /calls/{call_control_id}/actions/refer
      operations:
      - name: refercall
        method: POST
        description: SIP Refer a call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-reject
      path: /calls/{call_control_id}/actions/reject
      operations:
      - name: rejectcall
        method: POST
        description: Reject a call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-send_dtmf
      path: /calls/{call_control_id}/actions/send_dtmf
      operations:
      - name: senddtmf
        method: POST
        description: Send DTMF
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-send_sip_info
      path: /calls/{call_control_id}/actions/send_sip_info
      operations:
      - name: sendsipinfo
        method: POST
        description: Send SIP info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-siprec_start
      path: /calls/{call_control_id}/actions/siprec_start
      operations:
      - name: startsiprecsession
        method: POST
        description: SIPREC start
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-siprec_stop
      path: /calls/{call_control_id}/actions/siprec_stop
      operations:
      - name: stopsiprecsession
        method: POST
        description: SIPREC stop
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-speak
      path: /calls/{call_control_id}/actions/speak
      operations:
      - name: speakcall
        method: POST
        description: Speak text
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-streaming_start
      path: /calls/{call_control_id}/actions/streaming_start
      operations:
      - name: startcallstreaming
        method: POST
        description: Streaming start
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-streaming_stop
      path: /calls/{call_control_id}/actions/streaming_stop
      operations:
      - name: stopcallstreaming
        method: POST
        description: Streaming stop
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-suppression_start
      path: /calls/{call_control_id}/actions/suppression_start
      operations:
      - name: noisesuppressionstart
        method: POST
        description: Noise Suppression Start (BETA)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-suppression_stop
      path: /calls/{call_control_id}/actions/suppression_stop
      operations:
      - name: noisesuppressionstop
        method: POST
        description: Noise Suppression Stop (BETA)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-switch_supervisor_role
      path: /calls/{call_control_id}/actions/switch_supervisor_role
      operations:
      - name: switchsupervisorrole
        method: POST
        description: Switch supervisor role
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-transcription_start
      path: /calls/{call_control_id}/actions/transcription_start
      operations:
      - name: startcalltranscription
        method: POST
        description: Transcription start
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-transcription_stop
      path: /calls/{call_control_id}/actions/transcription_stop
      operations:
      - name: stopcalltranscription
        method: POST
        description: Transcription stop
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: calls-call_control_id-actions-transfer
      path: /calls/{call_control_id}/actions/transfer
      operations:
      - name: transfercall
        method: POST
        description: Transfer call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.TELNYX_API_KEY}}'
  exposes:
  - type: rest
    namespace: telnyx-call-commands-rest
    port: 8080
    description: REST adapter for Telnyx API — Call Commands. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/calls
      name: calls
      description: REST surface for calls.
      operations:
      - method: POST
        name: dialcall
        description: Dial
        call: telnyx-call-commands.dialcall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/ai-assistant-add-messages
      name: calls-call-control-id-actions-ai-assistant-add-messages
      description: REST surface for calls-call_control_id-actions-ai_assistant_add_messages.
      operations:
      - method: POST
        name: calladdmessagestoaiassistant
        description: Add messages to AI Assistant
        call: telnyx-call-commands.calladdmessagestoaiassistant
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/ai-assistant-join
      name: calls-call-control-id-actions-ai-assistant-join
      description: REST surface for calls-call_control_id-actions-ai_assistant_join.
      operations:
      - method: POST
        name: calljoinaiassistant
        description: Join AI Assistant Conversation
        call: telnyx-call-commands.calljoinaiassistant
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/ai-assistant-start
      name: calls-call-control-id-actions-ai-assistant-start
      description: REST surface for calls-call_control_id-actions-ai_assistant_start.
      operations:
      - method: POST
        name: callstartaiassistant
        description: Start AI Assistant
        call: telnyx-call-commands.callstartaiassistant
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/ai-assistant-stop
      name: calls-call-control-id-actions-ai-assistant-stop
      description: REST surface for calls-call_control_id-actions-ai_assistant_stop.
      operations:
      - method: POST
        name: callstopaiassistant
        description: Stop AI Assistant
        call: telnyx-call-commands.callstopaiassistant
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/answer
      name: calls-call-control-id-actions-answer
      description: REST surface for calls-call_control_id-actions-answer.
      operations:
      - method: POST
        name: answercall
        description: Answer call
        call: telnyx-call-commands.answercall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/bridge
      name: calls-call-control-id-actions-bridge
      description: REST surface for calls-call_control_id-actions-bridge.
      operations:
      - method: POST
        name: bridgecall
        description: Bridge calls
        call: telnyx-call-commands.bridgecall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/client-state-update
      name: calls-call-control-id-actions-client-state-update
      description: REST surface for calls-call_control_id-actions-client_state_update.
      operations:
      - method: PUT
        name: updateclientstate
        description: Update client state
        call: telnyx-call-commands.updateclientstate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/enqueue
      name: calls-call-control-id-actions-enqueue
      description: REST surface for calls-call_control_id-actions-enqueue.
      operations:
      - method: POST
        name: enqueuecall
        description: Enqueue call
        call: telnyx-call-commands.enqueuecall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/fork-start
      name: calls-call-control-id-actions-fork-start
      description: REST surface for calls-call_control_id-actions-fork_start.
      operations:
      - method: POST
        name: startcallfork
        description: Forking start
        call: telnyx-call-commands.startcallfork
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/fork-stop
      name: calls-call-control-id-actions-fork-stop
      description: REST surface for calls-call_control_id-actions-fork_stop.
      operations:
      - method: POST
        name: stopcallfork
        description: Forking stop
        call: telnyx-call-commands.stopcallfork
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/gather
      name: calls-call-control-id-actions-gather
      description: REST surface for calls-call_control_id-actions-gather.
      operations:
      - method: POST
        name: gathercall
        description: Gather
        call: telnyx-call-commands.gathercall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/gather-stop
      name: calls-call-control-id-actions-gather-stop
      description: REST surface for calls-call_control_id-actions-gather_stop.
      operations:
      - method: POST
        name: stopcallgather
        description: Gather stop
        call: telnyx-call-commands.stopcallgather
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/gather-using-ai
      name: calls-call-control-id-actions-gather-using-ai
      description: REST surface for calls-call_control_id-actions-gather_using_ai.
      operations:
      - method: POST
        name: callgatherusingai
        description: Gather using AI
        call: telnyx-call-commands.callgatherusingai
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/gather-using-audio
      name: calls-call-control-id-actions-gather-using-audio
      description: REST surface for calls-call_control_id-actions-gather_using_audio.
      operations:
      - method: POST
        name: gatherusingaudio
        description: Gather using audio
        call: telnyx-call-commands.gatherusingaudio
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/gather-using-speak
      name: calls-call-control-id-actions-gather-using-speak
      description: REST surface for calls-call_control_id-actions-gather_using_speak.
      operations:
      - method: POST
        name: gatherusingspeak
        description: Gather using speak
        call: telnyx-call-commands.gatherusingspeak
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/hangup
      name: calls-call-control-id-actions-hangup
      description: REST surface for calls-call_control_id-actions-hangup.
      operations:
      - method: POST
        name: hangupcall
        description: Hangup call
        call: telnyx-call-commands.hangupcall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/leave-queue
      name: calls-call-control-id-actions-leave-queue
      description: REST surface for calls-call_control_id-actions-leave_queue.
      operations:
      - method: POST
        name: leavequeue
        description: Remove call from a queue
        call: telnyx-call-commands.leavequeue
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/playback-start
      name: calls-call-control-id-actions-playback-start
      description: REST surface for calls-call_control_id-actions-playback_start.
      operations:
      - method: POST
        name: startcallplayback
        description: Play audio URL
        call: telnyx-call-commands.startcallplayback
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/playback-stop
      name: calls-call-control-id-actions-playback-stop
      description: REST surface for calls-call_control_id-actions-playback_stop.
      operations:
      - method: POST
        name: stopcallplayback
        description: Stop audio playback
        call: telnyx-call-commands.stopcallplayback
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/record-pause
      name: calls-call-control-id-actions-record-pause
      description: REST surface for calls-call_control_id-actions-record_pause.
      operations:
      - method: POST
        name: pausecallrecording
        description: Record pause
        call: telnyx-call-commands.pausecallrecording
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/record-resume
      name: calls-call-control-id-actions-record-resume
      description: REST surface for calls-call_control_id-actions-record_resume.
      operations:
      - method: POST
        name: resumecallrecording
        description: Record resume
        call: telnyx-call-commands.resumecallrecording
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/record-start
      name: calls-call-control-id-actions-record-start
      description: REST surface for calls-call_control_id-actions-record_start.
      operations:
      - method: POST
        name: startcallrecord
        description: Recording start
        call: telnyx-call-commands.startcallrecord
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/record-stop
      name: calls-call-control-id-actions-record-stop
      description: REST surface for calls-call_control_id-actions-record_stop.
      operations:
      - method: POST
        name: stopcallrecording
        description: Recording stop
        call: telnyx-call-commands.stopcallrecording
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/refer
      name: calls-call-control-id-actions-refer
      description: REST surface for calls-call_control_id-actions-refer.
      operations:
      - method: POST
        name: refercall
        description: SIP Refer a call
        call: telnyx-call-commands.refercall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/reject
      name: calls-call-control-id-actions-reject
      description: REST surface for calls-call_control_id-actions-reject.
      operations:
      - method: POST
        name: rejectcall
        description: Reject a call
        call: telnyx-call-commands.rejectcall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/send-dtmf
      name: calls-call-control-id-actions-send-dtmf
      description: REST surface for calls-call_control_id-actions-send_dtmf.
      operations:
      - method: POST
        name: senddtmf
        description: Send DTMF
        call: telnyx-call-commands.senddtmf
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/send-sip-info
      name: calls-call-control-id-actions-send-sip-info
      description: REST surface for calls-call_control_id-actions-send_sip_info.
      operations:
      - method: POST
        name: sendsipinfo
        description: Send SIP info
        call: telnyx-call-commands.sendsipinfo
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/siprec-start
      name: calls-call-control-id-actions-siprec-start
      description: REST surface for calls-call_control_id-actions-siprec_start.
      operations:
      - method: POST
        name: startsiprecsession
        description: SIPREC start
        call: telnyx-call-commands.startsiprecsession
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/siprec-stop
      name: calls-call-control-id-actions-siprec-stop
      description: REST surface for calls-call_control_id-actions-siprec_stop.
      operations:
      - method: POST
        name: stopsiprecsession
        description: SIPREC stop
        call: telnyx-call-commands.stopsiprecsession
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/speak
      name: calls-call-control-id-actions-speak
      description: REST surface for calls-call_control_id-actions-speak.
      operations:
      - method: POST
        name: speakcall
        description: Speak text
        call: telnyx-call-commands.speakcall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/streaming-start
      name: calls-call-control-id-actions-streaming-start
      description: REST surface for calls-call_control_id-actions-streaming_start.
      operations:
      - method: POST
        name: startcallstreaming
        description: Streaming start
        call: telnyx-call-commands.startcallstreaming
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/streaming-stop
      name: calls-call-control-id-actions-streaming-stop
      description: REST surface for calls-call_control_id-actions-streaming_stop.
      operations:
      - method: POST
        name: stopcallstreaming
        description: Streaming stop
        call: telnyx-call-commands.stopcallstreaming
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/suppression-start
      name: calls-call-control-id-actions-suppression-start
      description: REST surface for calls-call_control_id-actions-suppression_start.
      operations:
      - method: POST
        name: noisesuppressionstart
        description: Noise Suppression Start (BETA)
        call: telnyx-call-commands.noisesuppressionstart
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/suppression-stop
      name: calls-call-control-id-actions-suppression-stop
      description: REST surface for calls-call_control_id-actions-suppression_stop.
      operations:
      - method: POST
        name: noisesuppressionstop
        description: Noise Suppression Stop (BETA)
        call: telnyx-call-commands.noisesuppressionstop
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/switch-supervisor-role
      name: calls-call-control-id-actions-switch-supervisor-role
      description: REST surface for calls-call_control_id-actions-switch_supervisor_role.
      operations:
      - method: POST
        name: switchsupervisorrole
        description: Switch supervisor role
        call: telnyx-call-commands.switchsupervisorrole
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/transcription-start
      name: calls-call-control-id-actions-transcription-start
      description: REST surface for calls-call_control_id-actions-transcription_start.
      operations:
      - method: POST
        name: startcalltranscription
        description: Transcription start
        call: telnyx-call-commands.startcalltranscription
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/transcription-stop
      name: calls-call-control-id-actions-transcription-stop
      description: REST surface for calls-call_control_id-actions-transcription_stop.
      operations:
      - method: POST
        name: stopcalltranscription
        description: Transcription stop
        call: telnyx-call-commands.stopcalltranscription
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calls/{call-control-id}/actions/transfer
      name: calls-call-control-id-actions-transfer
      description: REST surface for calls-call_control_id-actions-transfer.
      operations:
      - method: POST
        name: transfercall
        description: Transfer call
        call: telnyx-call-commands.transfercall
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: telnyx-call-commands-mcp
    port: 9090
    transport: http
    description: MCP adapter for Telnyx API — Call Commands. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: dial
      description: Dial
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.dialcall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: add-messages-ai-assistant
      description: Add messages to AI Assistant
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.calladdmessagestoaiassistant
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: join-ai-assistant-conversation
      description: Join AI Assistant Conversation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.calljoinaiassistant
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: start-ai-assistant
      description: Start AI Assistant
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.callstartaiassistant
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: stop-ai-assistant
      description: Stop AI Assistant
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.callstopaiassistant
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: answer-call
      description: Answer call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.answercall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: bridge-calls
      description: Bridge calls
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.bridgecall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-client-state
      description: Update client state
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: telnyx-call-commands.updateclientstate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: enqueue-call
      description: Enqueue call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.enqueuecall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: forking-start
      description: Forking start
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.startcallfork
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: forking-stop
      description: Forking stop
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.stopcallfork
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gather
      description: Gather
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.gathercall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gather-stop
      description: Gather stop
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.stopcallgather
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gather-using-ai
      description: Gather using AI
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.callgatherusingai
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gather-using-audio
      description: Gather using audio
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.gatherusingaudio
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gather-using-speak
      description: Gather using speak
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.gatherusingspeak
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: hangup-call
      description: Hangup call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.hangupcall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: remove-call-queue
      description: Remove call from a queue
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.leavequeue
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: play-audio-url
      description: Play audio URL
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.startcallplayback
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: stop-audio-playback
      description: Stop audio playback
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.stopcallplayback
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: record-pause
      description: Record pause
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.pausecallrecording
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: record-resume
      description: Record resume
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.resumecallrecording
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: recording-start
      description: Recording start
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.startcallrecord
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: recording-stop
      description: Recording stop
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.stopcallrecording
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: sip-refer-call
      description: SIP Refer a call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.refercall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: reject-call
      description: Reject a call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.rejectcall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: send-dtmf
      description: Send DTMF
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.senddtmf
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: send-sip-info
      description: Send SIP info
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.sendsipinfo
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: siprec-start
      description: SIPREC start
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.startsiprecsession
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: siprec-stop
      description: SIPREC stop
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.stopsiprecsession
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: speak-text
      description: Speak text
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.speakcall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: streaming-start
      description: Streaming start
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.startcallstreaming
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: streaming-stop
      description: Streaming stop
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.stopcallstreaming
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: noise-suppression-start-beta
      description: Noise Suppression Start (BETA)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.noisesuppressionstart
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: noise-suppression-stop-beta
      description: Noise Suppression Stop (BETA)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.noisesuppressionstop
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: switch-supervisor-role
      description: Switch supervisor role
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.switchsupervisorrole
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: transcription-start
      description: Transcription start
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.startcalltranscription
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: transcription-stop
      description: Transcription stop
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.stopcalltranscription
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: transfer-call
      description: Transfer call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-call-commands.transfercall
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.