naftiko: 1.0.0-alpha2 info: label: Telnyx API — Conference Commands description: 'Telnyx API — Conference Commands. 23 operations. Lead operation: List conferences. Self-contained Naftiko capability covering one Telnyx business surface.' tags: - Telnyx - Conference 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-conference-commands baseUri: https://api.telnyx.com/v2 description: Telnyx API — Conference Commands business capability. Self-contained, no shared references. resources: - name: conferences path: /conferences operations: - name: listconferences method: GET description: List conferences outputRawFormat: json outputParameters: - name: result type: object value: $. - name: createconference method: POST description: Create conference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-conference_id-participants path: /conferences/{conference_id}/participants operations: - name: listconferenceparticipants method: GET description: List conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: conference_id in: path type: string description: Uniquely identifies the conference by id required: true - name: filter in: query type: object description: 'Consolidated filter parameter (deepObject style). Originally: filter[muted], filter[on_hold], filter[whispering]' - name: conferences-id path: /conferences/{id} operations: - name: retrieveconference method: GET description: Retrieve a conference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id required: true - name: conferences-id-actions-end path: /conferences/{id}/actions/end operations: - name: endconference method: POST description: End a conference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: conferences-id-actions-gather_using_audio path: /conferences/{id}/actions/gather_using_audio operations: - name: conferencegatherusingaudio method: POST description: Gather DTMF using audio prompt in a conference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: conferences-id-actions-hold path: /conferences/{id}/actions/hold operations: - name: holdconferenceparticipants method: POST description: Hold conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-join path: /conferences/{id}/actions/join operations: - name: joinconference method: POST description: Join a conference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-leave path: /conferences/{id}/actions/leave operations: - name: leaveconference method: POST description: Leave a conference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-mute path: /conferences/{id}/actions/mute operations: - name: muteconferenceparticipants method: POST description: Mute conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-play path: /conferences/{id}/actions/play operations: - name: playconferenceaudio method: POST description: Play audio to conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-record_pause path: /conferences/{id}/actions/record_pause operations: - name: pauseconferencerecording method: POST description: Conference recording pause outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Specifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-record_resume path: /conferences/{id}/actions/record_resume operations: - name: resumeconferencerecording method: POST description: Conference recording resume outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Specifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-record_start path: /conferences/{id}/actions/record_start operations: - name: startconferencerecording method: POST description: Conference recording start outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Specifies the conference to record by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-record_stop path: /conferences/{id}/actions/record_stop operations: - name: stopconferencerecording method: POST description: Conference recording stop outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Specifies the conference to stop the recording for by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-send_dtmf path: /conferences/{id}/actions/send_dtmf operations: - name: conferencesenddtmf method: POST description: Send DTMF to conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: conferences-id-actions-speak path: /conferences/{id}/actions/speak operations: - name: speaktexttoconference method: POST description: Speak text to conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Specifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-stop path: /conferences/{id}/actions/stop operations: - name: stopconferenceaudio method: POST description: Stop audio being played on the conference outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-unhold path: /conferences/{id}/actions/unhold operations: - name: unholdconferenceparticipants method: POST description: Unhold conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-unmute path: /conferences/{id}/actions/unmute operations: - name: unmuteconferenceparticipants method: POST description: Unmute conference participants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-actions-update path: /conferences/{id}/actions/update operations: - name: updateconference method: POST description: Update conference participant outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference by id or name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: conferences-id-participants-participant_id path: /conferences/{id}/participants/{participant_id} operations: - name: retrieveconferenceparticipant method: GET description: Retrieve a conference participant outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference. required: true - name: participant_id in: path type: string description: Uniquely identifies the participant by their ID or label. required: true - name: updateconferenceparticipant method: PATCH description: Update a conference participant outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Uniquely identifies the conference. required: true - name: participant_id in: path type: string description: Uniquely identifies the participant. required: true - name: body in: body type: object description: Request body (JSON). required: false authentication: type: bearer token: '{{env.TELNYX_API_KEY}}' exposes: - type: rest namespace: telnyx-conference-commands-rest port: 8080 description: REST adapter for Telnyx API — Conference Commands. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/conferences name: conferences description: REST surface for conferences. operations: - method: GET name: listconferences description: List conferences call: telnyx-conference-commands.listconferences outputParameters: - type: object mapping: $. - method: POST name: createconference description: Create conference call: telnyx-conference-commands.createconference with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{conference-id}/participants name: conferences-conference-id-participants description: REST surface for conferences-conference_id-participants. operations: - method: GET name: listconferenceparticipants description: List conference participants call: telnyx-conference-commands.listconferenceparticipants with: conference_id: rest.conference_id filter: rest.filter outputParameters: - type: object mapping: $. - path: /v1/conferences/{id} name: conferences-id description: REST surface for conferences-id. operations: - method: GET name: retrieveconference description: Retrieve a conference call: telnyx-conference-commands.retrieveconference with: id: rest.id outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/end name: conferences-id-actions-end description: REST surface for conferences-id-actions-end. operations: - method: POST name: endconference description: End a conference call: telnyx-conference-commands.endconference with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/gather-using-audio name: conferences-id-actions-gather-using-audio description: REST surface for conferences-id-actions-gather_using_audio. operations: - method: POST name: conferencegatherusingaudio description: Gather DTMF using audio prompt in a conference call: telnyx-conference-commands.conferencegatherusingaudio with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/hold name: conferences-id-actions-hold description: REST surface for conferences-id-actions-hold. operations: - method: POST name: holdconferenceparticipants description: Hold conference participants call: telnyx-conference-commands.holdconferenceparticipants with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/join name: conferences-id-actions-join description: REST surface for conferences-id-actions-join. operations: - method: POST name: joinconference description: Join a conference call: telnyx-conference-commands.joinconference with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/leave name: conferences-id-actions-leave description: REST surface for conferences-id-actions-leave. operations: - method: POST name: leaveconference description: Leave a conference call: telnyx-conference-commands.leaveconference with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/mute name: conferences-id-actions-mute description: REST surface for conferences-id-actions-mute. operations: - method: POST name: muteconferenceparticipants description: Mute conference participants call: telnyx-conference-commands.muteconferenceparticipants with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/play name: conferences-id-actions-play description: REST surface for conferences-id-actions-play. operations: - method: POST name: playconferenceaudio description: Play audio to conference participants call: telnyx-conference-commands.playconferenceaudio with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/record-pause name: conferences-id-actions-record-pause description: REST surface for conferences-id-actions-record_pause. operations: - method: POST name: pauseconferencerecording description: Conference recording pause call: telnyx-conference-commands.pauseconferencerecording with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/record-resume name: conferences-id-actions-record-resume description: REST surface for conferences-id-actions-record_resume. operations: - method: POST name: resumeconferencerecording description: Conference recording resume call: telnyx-conference-commands.resumeconferencerecording with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/record-start name: conferences-id-actions-record-start description: REST surface for conferences-id-actions-record_start. operations: - method: POST name: startconferencerecording description: Conference recording start call: telnyx-conference-commands.startconferencerecording with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/record-stop name: conferences-id-actions-record-stop description: REST surface for conferences-id-actions-record_stop. operations: - method: POST name: stopconferencerecording description: Conference recording stop call: telnyx-conference-commands.stopconferencerecording with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/send-dtmf name: conferences-id-actions-send-dtmf description: REST surface for conferences-id-actions-send_dtmf. operations: - method: POST name: conferencesenddtmf description: Send DTMF to conference participants call: telnyx-conference-commands.conferencesenddtmf with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/speak name: conferences-id-actions-speak description: REST surface for conferences-id-actions-speak. operations: - method: POST name: speaktexttoconference description: Speak text to conference participants call: telnyx-conference-commands.speaktexttoconference with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/stop name: conferences-id-actions-stop description: REST surface for conferences-id-actions-stop. operations: - method: POST name: stopconferenceaudio description: Stop audio being played on the conference call: telnyx-conference-commands.stopconferenceaudio with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/unhold name: conferences-id-actions-unhold description: REST surface for conferences-id-actions-unhold. operations: - method: POST name: unholdconferenceparticipants description: Unhold conference participants call: telnyx-conference-commands.unholdconferenceparticipants with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/unmute name: conferences-id-actions-unmute description: REST surface for conferences-id-actions-unmute. operations: - method: POST name: unmuteconferenceparticipants description: Unmute conference participants call: telnyx-conference-commands.unmuteconferenceparticipants with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/actions/update name: conferences-id-actions-update description: REST surface for conferences-id-actions-update. operations: - method: POST name: updateconference description: Update conference participant call: telnyx-conference-commands.updateconference with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/conferences/{id}/participants/{participant-id} name: conferences-id-participants-participant-id description: REST surface for conferences-id-participants-participant_id. operations: - method: GET name: retrieveconferenceparticipant description: Retrieve a conference participant call: telnyx-conference-commands.retrieveconferenceparticipant with: id: rest.id participant_id: rest.participant_id outputParameters: - type: object mapping: $. - method: PATCH name: updateconferenceparticipant description: Update a conference participant call: telnyx-conference-commands.updateconferenceparticipant with: id: rest.id participant_id: rest.participant_id body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: telnyx-conference-commands-mcp port: 9090 transport: http description: MCP adapter for Telnyx API — Conference Commands. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: list-conferences description: List conferences hints: readOnly: true destructive: false idempotent: true call: telnyx-conference-commands.listconferences outputParameters: - type: object mapping: $. - name: create-conference description: Create conference hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.createconference with: body: tools.body outputParameters: - type: object mapping: $. - name: list-conference-participants description: List conference participants hints: readOnly: true destructive: false idempotent: true call: telnyx-conference-commands.listconferenceparticipants with: conference_id: tools.conference_id filter: tools.filter outputParameters: - type: object mapping: $. - name: retrieve-conference description: Retrieve a conference hints: readOnly: true destructive: false idempotent: true call: telnyx-conference-commands.retrieveconference with: id: tools.id outputParameters: - type: object mapping: $. - name: end-conference description: End a conference hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.endconference with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: gather-dtmf-using-audio-prompt description: Gather DTMF using audio prompt in a conference hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.conferencegatherusingaudio with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: hold-conference-participants description: Hold conference participants hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.holdconferenceparticipants with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: join-conference description: Join a conference hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.joinconference with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: leave-conference description: Leave a conference hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.leaveconference with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: mute-conference-participants description: Mute conference participants hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.muteconferenceparticipants with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: play-audio-conference-participants description: Play audio to conference participants hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.playconferenceaudio with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: conference-recording-pause description: Conference recording pause hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.pauseconferencerecording with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: conference-recording-resume description: Conference recording resume hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.resumeconferencerecording with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: conference-recording-start description: Conference recording start hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.startconferencerecording with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: conference-recording-stop description: Conference recording stop hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.stopconferencerecording with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: send-dtmf-conference-participants description: Send DTMF to conference participants hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.conferencesenddtmf with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: speak-text-conference-participants description: Speak text to conference participants hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.speaktexttoconference with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: stop-audio-being-played-conference description: Stop audio being played on the conference hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.stopconferenceaudio with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: unhold-conference-participants description: Unhold conference participants hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.unholdconferenceparticipants with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: unmute-conference-participants description: Unmute conference participants hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.unmuteconferenceparticipants with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-conference-participant description: Update conference participant hints: readOnly: false destructive: false idempotent: false call: telnyx-conference-commands.updateconference with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: retrieve-conference-participant description: Retrieve a conference participant hints: readOnly: true destructive: false idempotent: true call: telnyx-conference-commands.retrieveconferenceparticipant with: id: tools.id participant_id: tools.participant_id outputParameters: - type: object mapping: $. - name: update-conference-participant-2 description: Update a conference participant hints: readOnly: false destructive: false idempotent: true call: telnyx-conference-commands.updateconferenceparticipant with: id: tools.id participant_id: tools.participant_id body: tools.body outputParameters: - type: object mapping: $.