naftiko: 1.0.0-alpha2 info: label: Telnyx API — Missions description: 'Telnyx API — Missions. 41 operations. Lead operation: List missions. Self-contained Naftiko capability covering one Telnyx business surface.' tags: - Telnyx - Missions created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: TELNYX_API_KEY: TELNYX_API_KEY capability: consumes: - type: http namespace: telnyx-missions baseUri: https://api.telnyx.com/v2 description: Telnyx API — Missions business capability. Self-contained, no shared references. resources: - name: ai-missions path: /ai/missions operations: - name: getpublicmissionsmissions method: GET description: List missions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: page[number] in: query type: integer description: Page number (1-based) - name: page[size] in: query type: integer description: Number of items per page - name: postpublicmissionsmissions method: POST description: Create mission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-events path: /ai/missions/events operations: - name: getpublicmissionsmissionsevents method: GET description: List recent events outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: type in: query type: string - name: page[number] in: query type: integer description: Page number (1-based) - name: page[size] in: query type: integer description: Number of items per page - name: ai-missions-runs path: /ai/missions/runs operations: - name: getpublicmissionsmissionsruns method: GET description: List recent runs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string - name: page[number] in: query type: integer description: Page number (1-based) - name: page[size] in: query type: integer description: Number of items per page - name: ai-missions-mission_id path: /ai/missions/{mission_id} operations: - name: deletepublicmissionsmissionsmissionid method: DELETE description: Delete mission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: getpublicmissionsmissionsmissionid method: GET description: Get mission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: putpublicmissionsmissionsmissionid method: PUT description: Update mission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-mission_id-clone path: /ai/missions/{mission_id}/clone operations: - name: postpublicmissionsmissionsmissionidclone method: POST description: Clone mission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: ai-missions-mission_id-knowledge-bases path: /ai/missions/{mission_id}/knowledge-bases operations: - name: getpublicmissionsmissionsmissionidknowledgebases method: GET description: List knowledge bases outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: postpublicmissionsmissionsmissionidknowledgebases method: POST description: Create knowledge base outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: ai-missions-mission_id-knowledge-bases-knowledge_base_id path: /ai/missions/{mission_id}/knowledge-bases/{knowledge_base_id} operations: - name: deletepublicmissionsmissionsmissionidknowledgebasesknowledgebaseid method: DELETE description: Delete knowledge base outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: knowledge_base_id in: path type: string required: true - name: getpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid method: GET description: Get knowledge base outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: knowledge_base_id in: path type: string required: true - name: putpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid method: PUT description: Update knowledge base outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: knowledge_base_id in: path type: string required: true - name: ai-missions-mission_id-mcp-servers path: /ai/missions/{mission_id}/mcp-servers operations: - name: getpublicmissionsmissionsmissionidmcpservers method: GET description: List MCP servers outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: postpublicmissionsmissionsmissionidmcpservers method: POST description: Create MCP server outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: ai-missions-mission_id-mcp-servers-mcp_server_id path: /ai/missions/{mission_id}/mcp-servers/{mcp_server_id} operations: - name: deletepublicmissionsmissionsmissionidmcpserversmcpserverid method: DELETE description: Delete MCP server outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: mcp_server_id in: path type: string required: true - name: getpublicmissionsmissionsmissionidmcpserversmcpserverid method: GET description: Get MCP server outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: mcp_server_id in: path type: string required: true - name: putpublicmissionsmissionsmissionidmcpserversmcpserverid method: PUT description: Update MCP server outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: mcp_server_id in: path type: string required: true - name: ai-missions-mission_id-runs path: /ai/missions/{mission_id}/runs operations: - name: getpublicmissionsmissionsmissionidruns method: GET description: List runs for mission outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: status in: query type: string - name: page[number] in: query type: integer description: Page number (1-based) - name: page[size] in: query type: integer description: Number of items per page - name: postpublicmissionsmissionsmissionidruns method: POST description: Start a run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: ai-missions-mission_id-runs-run_id path: /ai/missions/{mission_id}/runs/{run_id} operations: - name: getpublicmissionsmissionsmissionidrunsrunid method: GET description: Get run details outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: patchpublicmissionsmissionsmissionidrunsrunid method: PATCH description: Update run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-mission_id-runs-run_id-cancel path: /ai/missions/{mission_id}/runs/{run_id}/cancel operations: - name: postpublicmissionsmissionsmissionidrunsrunidcancel method: POST description: Cancel run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: ai-missions-mission_id-runs-run_id-events path: /ai/missions/{mission_id}/runs/{run_id}/events operations: - name: getpublicmissionsmissionsmissionidrunsrunidevents method: GET description: List events outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: type in: query type: string - name: step_id in: query type: string - name: agent_id in: query type: string - name: page[number] in: query type: integer description: Page number (1-based) - name: page[size] in: query type: integer description: Number of items per page - name: postpublicmissionsmissionsmissionidrunsrunidevents method: POST description: Log event outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-mission_id-runs-run_id-events-event_id path: /ai/missions/{mission_id}/runs/{run_id}/events/{event_id} operations: - name: getpublicmissionsmissionsmissionidrunsrunideventseventid method: GET description: Get event details outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: event_id in: path type: string required: true - name: ai-missions-mission_id-runs-run_id-pause path: /ai/missions/{mission_id}/runs/{run_id}/pause operations: - name: postpublicmissionsmissionsmissionidrunsrunidpause method: POST description: Pause run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: ai-missions-mission_id-runs-run_id-plan path: /ai/missions/{mission_id}/runs/{run_id}/plan operations: - name: getpublicmissionsmissionsmissionidrunsrunidplan method: GET description: Get plan outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: postpublicmissionsmissionsmissionidrunsrunidplan method: POST description: Create initial plan outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-mission_id-runs-run_id-plan-steps path: /ai/missions/{mission_id}/runs/{run_id}/plan/steps operations: - name: postpublicmissionsmissionsmissionidrunsrunidplansteps method: POST description: Add step(s) to plan outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-mission_id-runs-run_id-plan-steps-step_id path: /ai/missions/{mission_id}/runs/{run_id}/plan/steps/{step_id} operations: - name: getpublicmissionsmissionsmissionidrunsrunidplanstepsstepid method: GET description: Get step details outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: step_id in: path type: string required: true - name: patchpublicmissionsmissionsmissionidrunsrunidplanstepsstepid method: PATCH description: Update step status outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: step_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-mission_id-runs-run_id-resume path: /ai/missions/{mission_id}/runs/{run_id}/resume operations: - name: postpublicmissionsmissionsmissionidrunsrunidresume method: POST description: Resume run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: ai-missions-mission_id-runs-run_id-telnyx-agents path: /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents operations: - name: getpublicmissionsmissionsmissionidrunsrunidtelnyxagents method: GET description: List linked Telnyx agents outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: postpublicmissionsmissionsmissionidrunsrunidtelnyxagents method: POST description: Link Telnyx agent to run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ai-missions-mission_id-runs-run_id-telnyx-agents-telnyx_agent_id path: /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents/{telnyx_agent_id} operations: - name: deletepublicmissionsmissionsmissionidrunsrunidtelnyxagentstelnyxagentid method: DELETE description: Unlink Telnyx agent outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: run_id in: path type: string required: true - name: telnyx_agent_id in: path type: string required: true - name: ai-missions-mission_id-tools path: /ai/missions/{mission_id}/tools operations: - name: getpublicmissionsmissionsmissionidtools method: GET description: List tools outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: postpublicmissionsmissionsmissionidtools method: POST description: Create tool outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: ai-missions-mission_id-tools-tool_id path: /ai/missions/{mission_id}/tools/{tool_id} operations: - name: deletepublicmissionsmissionsmissionidtoolstoolid method: DELETE description: Delete tool outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: tool_id in: path type: string required: true - name: getpublicmissionsmissionsmissionidtoolstoolid method: GET description: Get tool outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: tool_id in: path type: string required: true - name: putpublicmissionsmissionsmissionidtoolstoolid method: PUT description: Update tool outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: mission_id in: path type: string required: true - name: tool_id in: path type: string required: true authentication: type: bearer token: '{{env.TELNYX_API_KEY}}' exposes: - type: rest namespace: telnyx-missions-rest port: 8080 description: REST adapter for Telnyx API — Missions. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/ai/missions name: ai-missions description: REST surface for ai-missions. operations: - method: GET name: getpublicmissionsmissions description: List missions call: telnyx-missions.getpublicmissionsmissions with: page[number]: rest.page[number] page[size]: rest.page[size] outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissions description: Create mission call: telnyx-missions.postpublicmissionsmissions with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/events name: ai-missions-events description: REST surface for ai-missions-events. operations: - method: GET name: getpublicmissionsmissionsevents description: List recent events call: telnyx-missions.getpublicmissionsmissionsevents with: type: rest.type page[number]: rest.page[number] page[size]: rest.page[size] outputParameters: - type: object mapping: $. - path: /v1/ai/missions/runs name: ai-missions-runs description: REST surface for ai-missions-runs. operations: - method: GET name: getpublicmissionsmissionsruns description: List recent runs call: telnyx-missions.getpublicmissionsmissionsruns with: status: rest.status page[number]: rest.page[number] page[size]: rest.page[size] outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id} name: ai-missions-mission-id description: REST surface for ai-missions-mission_id. operations: - method: DELETE name: deletepublicmissionsmissionsmissionid description: Delete mission call: telnyx-missions.deletepublicmissionsmissionsmissionid with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - method: GET name: getpublicmissionsmissionsmissionid description: Get mission call: telnyx-missions.getpublicmissionsmissionsmissionid with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - method: PUT name: putpublicmissionsmissionsmissionid description: Update mission call: telnyx-missions.putpublicmissionsmissionsmissionid with: mission_id: rest.mission_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/clone name: ai-missions-mission-id-clone description: REST surface for ai-missions-mission_id-clone. operations: - method: POST name: postpublicmissionsmissionsmissionidclone description: Clone mission call: telnyx-missions.postpublicmissionsmissionsmissionidclone with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/knowledge-bases name: ai-missions-mission-id-knowledge-bases description: REST surface for ai-missions-mission_id-knowledge-bases. operations: - method: GET name: getpublicmissionsmissionsmissionidknowledgebases description: List knowledge bases call: telnyx-missions.getpublicmissionsmissionsmissionidknowledgebases with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissionsmissionidknowledgebases description: Create knowledge base call: telnyx-missions.postpublicmissionsmissionsmissionidknowledgebases with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/knowledge-bases/{knowledge-base-id} name: ai-missions-mission-id-knowledge-bases-knowledge-base-id description: REST surface for ai-missions-mission_id-knowledge-bases-knowledge_base_id. operations: - method: DELETE name: deletepublicmissionsmissionsmissionidknowledgebasesknowledgebaseid description: Delete knowledge base call: telnyx-missions.deletepublicmissionsmissionsmissionidknowledgebasesknowledgebaseid with: mission_id: rest.mission_id knowledge_base_id: rest.knowledge_base_id outputParameters: - type: object mapping: $. - method: GET name: getpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid description: Get knowledge base call: telnyx-missions.getpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid with: mission_id: rest.mission_id knowledge_base_id: rest.knowledge_base_id outputParameters: - type: object mapping: $. - method: PUT name: putpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid description: Update knowledge base call: telnyx-missions.putpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid with: mission_id: rest.mission_id knowledge_base_id: rest.knowledge_base_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/mcp-servers name: ai-missions-mission-id-mcp-servers description: REST surface for ai-missions-mission_id-mcp-servers. operations: - method: GET name: getpublicmissionsmissionsmissionidmcpservers description: List MCP servers call: telnyx-missions.getpublicmissionsmissionsmissionidmcpservers with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissionsmissionidmcpservers description: Create MCP server call: telnyx-missions.postpublicmissionsmissionsmissionidmcpservers with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/mcp-servers/{mcp-server-id} name: ai-missions-mission-id-mcp-servers-mcp-server-id description: REST surface for ai-missions-mission_id-mcp-servers-mcp_server_id. operations: - method: DELETE name: deletepublicmissionsmissionsmissionidmcpserversmcpserverid description: Delete MCP server call: telnyx-missions.deletepublicmissionsmissionsmissionidmcpserversmcpserverid with: mission_id: rest.mission_id mcp_server_id: rest.mcp_server_id outputParameters: - type: object mapping: $. - method: GET name: getpublicmissionsmissionsmissionidmcpserversmcpserverid description: Get MCP server call: telnyx-missions.getpublicmissionsmissionsmissionidmcpserversmcpserverid with: mission_id: rest.mission_id mcp_server_id: rest.mcp_server_id outputParameters: - type: object mapping: $. - method: PUT name: putpublicmissionsmissionsmissionidmcpserversmcpserverid description: Update MCP server call: telnyx-missions.putpublicmissionsmissionsmissionidmcpserversmcpserverid with: mission_id: rest.mission_id mcp_server_id: rest.mcp_server_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs name: ai-missions-mission-id-runs description: REST surface for ai-missions-mission_id-runs. operations: - method: GET name: getpublicmissionsmissionsmissionidruns description: List runs for mission call: telnyx-missions.getpublicmissionsmissionsmissionidruns with: mission_id: rest.mission_id status: rest.status page[number]: rest.page[number] page[size]: rest.page[size] outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissionsmissionidruns description: Start a run call: telnyx-missions.postpublicmissionsmissionsmissionidruns with: mission_id: rest.mission_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id} name: ai-missions-mission-id-runs-run-id description: REST surface for ai-missions-mission_id-runs-run_id. operations: - method: GET name: getpublicmissionsmissionsmissionidrunsrunid description: Get run details call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunid with: mission_id: rest.mission_id run_id: rest.run_id outputParameters: - type: object mapping: $. - method: PATCH name: patchpublicmissionsmissionsmissionidrunsrunid description: Update run call: telnyx-missions.patchpublicmissionsmissionsmissionidrunsrunid with: mission_id: rest.mission_id run_id: rest.run_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/cancel name: ai-missions-mission-id-runs-run-id-cancel description: REST surface for ai-missions-mission_id-runs-run_id-cancel. operations: - method: POST name: postpublicmissionsmissionsmissionidrunsrunidcancel description: Cancel run call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidcancel with: mission_id: rest.mission_id run_id: rest.run_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/events name: ai-missions-mission-id-runs-run-id-events description: REST surface for ai-missions-mission_id-runs-run_id-events. operations: - method: GET name: getpublicmissionsmissionsmissionidrunsrunidevents description: List events call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidevents with: mission_id: rest.mission_id run_id: rest.run_id type: rest.type step_id: rest.step_id agent_id: rest.agent_id page[number]: rest.page[number] page[size]: rest.page[size] outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissionsmissionidrunsrunidevents description: Log event call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidevents with: mission_id: rest.mission_id run_id: rest.run_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/events/{event-id} name: ai-missions-mission-id-runs-run-id-events-event-id description: REST surface for ai-missions-mission_id-runs-run_id-events-event_id. operations: - method: GET name: getpublicmissionsmissionsmissionidrunsrunideventseventid description: Get event details call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunideventseventid with: mission_id: rest.mission_id run_id: rest.run_id event_id: rest.event_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/pause name: ai-missions-mission-id-runs-run-id-pause description: REST surface for ai-missions-mission_id-runs-run_id-pause. operations: - method: POST name: postpublicmissionsmissionsmissionidrunsrunidpause description: Pause run call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidpause with: mission_id: rest.mission_id run_id: rest.run_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/plan name: ai-missions-mission-id-runs-run-id-plan description: REST surface for ai-missions-mission_id-runs-run_id-plan. operations: - method: GET name: getpublicmissionsmissionsmissionidrunsrunidplan description: Get plan call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidplan with: mission_id: rest.mission_id run_id: rest.run_id outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissionsmissionidrunsrunidplan description: Create initial plan call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidplan with: mission_id: rest.mission_id run_id: rest.run_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/plan/steps name: ai-missions-mission-id-runs-run-id-plan-steps description: REST surface for ai-missions-mission_id-runs-run_id-plan-steps. operations: - method: POST name: postpublicmissionsmissionsmissionidrunsrunidplansteps description: Add step(s) to plan call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidplansteps with: mission_id: rest.mission_id run_id: rest.run_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/plan/steps/{step-id} name: ai-missions-mission-id-runs-run-id-plan-steps-step-id description: REST surface for ai-missions-mission_id-runs-run_id-plan-steps-step_id. operations: - method: GET name: getpublicmissionsmissionsmissionidrunsrunidplanstepsstepid description: Get step details call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidplanstepsstepid with: mission_id: rest.mission_id run_id: rest.run_id step_id: rest.step_id outputParameters: - type: object mapping: $. - method: PATCH name: patchpublicmissionsmissionsmissionidrunsrunidplanstepsstepid description: Update step status call: telnyx-missions.patchpublicmissionsmissionsmissionidrunsrunidplanstepsstepid with: mission_id: rest.mission_id run_id: rest.run_id step_id: rest.step_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/resume name: ai-missions-mission-id-runs-run-id-resume description: REST surface for ai-missions-mission_id-runs-run_id-resume. operations: - method: POST name: postpublicmissionsmissionsmissionidrunsrunidresume description: Resume run call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidresume with: mission_id: rest.mission_id run_id: rest.run_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/telnyx-agents name: ai-missions-mission-id-runs-run-id-telnyx-agents description: REST surface for ai-missions-mission_id-runs-run_id-telnyx-agents. operations: - method: GET name: getpublicmissionsmissionsmissionidrunsrunidtelnyxagents description: List linked Telnyx agents call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidtelnyxagents with: mission_id: rest.mission_id run_id: rest.run_id outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissionsmissionidrunsrunidtelnyxagents description: Link Telnyx agent to run call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidtelnyxagents with: mission_id: rest.mission_id run_id: rest.run_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/runs/{run-id}/telnyx-agents/{telnyx-agent-id} name: ai-missions-mission-id-runs-run-id-telnyx-agents-telnyx-agent-id description: REST surface for ai-missions-mission_id-runs-run_id-telnyx-agents-telnyx_agent_id. operations: - method: DELETE name: deletepublicmissionsmissionsmissionidrunsrunidtelnyxagentstelnyxagentid description: Unlink Telnyx agent call: telnyx-missions.deletepublicmissionsmissionsmissionidrunsrunidtelnyxagentstelnyxagentid with: mission_id: rest.mission_id run_id: rest.run_id telnyx_agent_id: rest.telnyx_agent_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/tools name: ai-missions-mission-id-tools description: REST surface for ai-missions-mission_id-tools. operations: - method: GET name: getpublicmissionsmissionsmissionidtools description: List tools call: telnyx-missions.getpublicmissionsmissionsmissionidtools with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - method: POST name: postpublicmissionsmissionsmissionidtools description: Create tool call: telnyx-missions.postpublicmissionsmissionsmissionidtools with: mission_id: rest.mission_id outputParameters: - type: object mapping: $. - path: /v1/ai/missions/{mission-id}/tools/{tool-id} name: ai-missions-mission-id-tools-tool-id description: REST surface for ai-missions-mission_id-tools-tool_id. operations: - method: DELETE name: deletepublicmissionsmissionsmissionidtoolstoolid description: Delete tool call: telnyx-missions.deletepublicmissionsmissionsmissionidtoolstoolid with: mission_id: rest.mission_id tool_id: rest.tool_id outputParameters: - type: object mapping: $. - method: GET name: getpublicmissionsmissionsmissionidtoolstoolid description: Get tool call: telnyx-missions.getpublicmissionsmissionsmissionidtoolstoolid with: mission_id: rest.mission_id tool_id: rest.tool_id outputParameters: - type: object mapping: $. - method: PUT name: putpublicmissionsmissionsmissionidtoolstoolid description: Update tool call: telnyx-missions.putpublicmissionsmissionsmissionidtoolstoolid with: mission_id: rest.mission_id tool_id: rest.tool_id outputParameters: - type: object mapping: $. - type: mcp namespace: telnyx-missions-mcp port: 9090 transport: http description: MCP adapter for Telnyx API — Missions. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: list-missions description: List missions hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissions with: page[number]: tools.page[number] page[size]: tools.page[size] outputParameters: - type: object mapping: $. - name: create-mission description: Create mission hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissions with: body: tools.body outputParameters: - type: object mapping: $. - name: list-recent-events description: List recent events hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsevents with: type: tools.type page[number]: tools.page[number] page[size]: tools.page[size] outputParameters: - type: object mapping: $. - name: list-recent-runs description: List recent runs hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsruns with: status: tools.status page[number]: tools.page[number] page[size]: tools.page[size] outputParameters: - type: object mapping: $. - name: delete-mission description: Delete mission hints: readOnly: false destructive: true idempotent: true call: telnyx-missions.deletepublicmissionsmissionsmissionid with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: get-mission description: Get mission hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionid with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: update-mission description: Update mission hints: readOnly: false destructive: false idempotent: true call: telnyx-missions.putpublicmissionsmissionsmissionid with: mission_id: tools.mission_id body: tools.body outputParameters: - type: object mapping: $. - name: clone-mission description: Clone mission hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidclone with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: list-knowledge-bases description: List knowledge bases hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidknowledgebases with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: create-knowledge-base description: Create knowledge base hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidknowledgebases with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: delete-knowledge-base description: Delete knowledge base hints: readOnly: false destructive: true idempotent: true call: telnyx-missions.deletepublicmissionsmissionsmissionidknowledgebasesknowledgebaseid with: mission_id: tools.mission_id knowledge_base_id: tools.knowledge_base_id outputParameters: - type: object mapping: $. - name: get-knowledge-base description: Get knowledge base hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid with: mission_id: tools.mission_id knowledge_base_id: tools.knowledge_base_id outputParameters: - type: object mapping: $. - name: update-knowledge-base description: Update knowledge base hints: readOnly: false destructive: false idempotent: true call: telnyx-missions.putpublicmissionsmissionsmissionidknowledgebasesknowledgebaseid with: mission_id: tools.mission_id knowledge_base_id: tools.knowledge_base_id outputParameters: - type: object mapping: $. - name: list-mcp-servers description: List MCP servers hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidmcpservers with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: create-mcp-server description: Create MCP server hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidmcpservers with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: delete-mcp-server description: Delete MCP server hints: readOnly: false destructive: true idempotent: true call: telnyx-missions.deletepublicmissionsmissionsmissionidmcpserversmcpserverid with: mission_id: tools.mission_id mcp_server_id: tools.mcp_server_id outputParameters: - type: object mapping: $. - name: get-mcp-server description: Get MCP server hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidmcpserversmcpserverid with: mission_id: tools.mission_id mcp_server_id: tools.mcp_server_id outputParameters: - type: object mapping: $. - name: update-mcp-server description: Update MCP server hints: readOnly: false destructive: false idempotent: true call: telnyx-missions.putpublicmissionsmissionsmissionidmcpserversmcpserverid with: mission_id: tools.mission_id mcp_server_id: tools.mcp_server_id outputParameters: - type: object mapping: $. - name: list-runs-mission description: List runs for mission hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidruns with: mission_id: tools.mission_id status: tools.status page[number]: tools.page[number] page[size]: tools.page[size] outputParameters: - type: object mapping: $. - name: start-run description: Start a run hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidruns with: mission_id: tools.mission_id body: tools.body outputParameters: - type: object mapping: $. - name: get-run-details description: Get run details hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunid with: mission_id: tools.mission_id run_id: tools.run_id outputParameters: - type: object mapping: $. - name: update-run description: Update run hints: readOnly: false destructive: false idempotent: true call: telnyx-missions.patchpublicmissionsmissionsmissionidrunsrunid with: mission_id: tools.mission_id run_id: tools.run_id body: tools.body outputParameters: - type: object mapping: $. - name: cancel-run description: Cancel run hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidcancel with: mission_id: tools.mission_id run_id: tools.run_id outputParameters: - type: object mapping: $. - name: list-events description: List events hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidevents with: mission_id: tools.mission_id run_id: tools.run_id type: tools.type step_id: tools.step_id agent_id: tools.agent_id page[number]: tools.page[number] page[size]: tools.page[size] outputParameters: - type: object mapping: $. - name: log-event description: Log event hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidevents with: mission_id: tools.mission_id run_id: tools.run_id body: tools.body outputParameters: - type: object mapping: $. - name: get-event-details description: Get event details hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunideventseventid with: mission_id: tools.mission_id run_id: tools.run_id event_id: tools.event_id outputParameters: - type: object mapping: $. - name: pause-run description: Pause run hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidpause with: mission_id: tools.mission_id run_id: tools.run_id outputParameters: - type: object mapping: $. - name: get-plan description: Get plan hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidplan with: mission_id: tools.mission_id run_id: tools.run_id outputParameters: - type: object mapping: $. - name: create-initial-plan description: Create initial plan hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidplan with: mission_id: tools.mission_id run_id: tools.run_id body: tools.body outputParameters: - type: object mapping: $. - name: add-step-s-plan description: Add step(s) to plan hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidplansteps with: mission_id: tools.mission_id run_id: tools.run_id body: tools.body outputParameters: - type: object mapping: $. - name: get-step-details description: Get step details hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidplanstepsstepid with: mission_id: tools.mission_id run_id: tools.run_id step_id: tools.step_id outputParameters: - type: object mapping: $. - name: update-step-status description: Update step status hints: readOnly: false destructive: false idempotent: true call: telnyx-missions.patchpublicmissionsmissionsmissionidrunsrunidplanstepsstepid with: mission_id: tools.mission_id run_id: tools.run_id step_id: tools.step_id body: tools.body outputParameters: - type: object mapping: $. - name: resume-run description: Resume run hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidresume with: mission_id: tools.mission_id run_id: tools.run_id outputParameters: - type: object mapping: $. - name: list-linked-telnyx-agents description: List linked Telnyx agents hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidrunsrunidtelnyxagents with: mission_id: tools.mission_id run_id: tools.run_id outputParameters: - type: object mapping: $. - name: link-telnyx-agent-run description: Link Telnyx agent to run hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidrunsrunidtelnyxagents with: mission_id: tools.mission_id run_id: tools.run_id body: tools.body outputParameters: - type: object mapping: $. - name: unlink-telnyx-agent description: Unlink Telnyx agent hints: readOnly: false destructive: true idempotent: true call: telnyx-missions.deletepublicmissionsmissionsmissionidrunsrunidtelnyxagentstelnyxagentid with: mission_id: tools.mission_id run_id: tools.run_id telnyx_agent_id: tools.telnyx_agent_id outputParameters: - type: object mapping: $. - name: list-tools description: List tools hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidtools with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: create-tool description: Create tool hints: readOnly: false destructive: false idempotent: false call: telnyx-missions.postpublicmissionsmissionsmissionidtools with: mission_id: tools.mission_id outputParameters: - type: object mapping: $. - name: delete-tool description: Delete tool hints: readOnly: false destructive: true idempotent: true call: telnyx-missions.deletepublicmissionsmissionsmissionidtoolstoolid with: mission_id: tools.mission_id tool_id: tools.tool_id outputParameters: - type: object mapping: $. - name: get-tool description: Get tool hints: readOnly: true destructive: false idempotent: true call: telnyx-missions.getpublicmissionsmissionsmissionidtoolstoolid with: mission_id: tools.mission_id tool_id: tools.tool_id outputParameters: - type: object mapping: $. - name: update-tool description: Update tool hints: readOnly: false destructive: false idempotent: true call: telnyx-missions.putpublicmissionsmissionsmissionidtoolstoolid with: mission_id: tools.mission_id tool_id: tools.tool_id outputParameters: - type: object mapping: $.