naftiko: 1.0.0-alpha2
info:
  label: Telnyx API — External Connections
  description: 'Telnyx API — External Connections. 23 operations. Lead operation: List all External Connections. Self-contained
    Naftiko capability covering one Telnyx business surface.'
  tags:
  - Telnyx
  - External Connections
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TELNYX_API_KEY: TELNYX_API_KEY
capability:
  consumes:
  - type: http
    namespace: telnyx-external-connections
    baseUri: https://api.telnyx.com/v2
    description: Telnyx API — External Connections business capability. Self-contained, no shared references.
    resources:
    - name: external_connections
      path: /external_connections
      operations:
      - name: listexternalconnections
        method: GET
        description: List all External Connections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createexternalconnection
        method: POST
        description: Creates an External Connection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: external_connections-log_messages
      path: /external_connections/log_messages
      operations:
      - name: listexternalconnectionlogmessages
        method: GET
        description: List all log messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-log_messages-id
      path: /external_connections/log_messages/{id}
      operations:
      - name: deleteexternalconnectionlogmessage
        method: DELETE
        description: Dismiss a log message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getexternalconnectionlogmessage
        method: GET
        description: Retrieve a log message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id
      path: /external_connections/{id}
      operations:
      - name: deleteexternalconnection
        method: DELETE
        description: Deletes an External Connection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getexternalconnection
        method: GET
        description: Retrieve an External Connection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateexternalconnection
        method: PATCH
        description: Update an External Connection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: external_connections-id-civic_addresses
      path: /external_connections/{id}/civic_addresses
      operations:
      - name: listcivicaddresses
        method: GET
        description: List all civic addresses and locations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-civic_addresses-address_id
      path: /external_connections/{id}/civic_addresses/{address_id}
      operations:
      - name: getexternalconnectioncivicaddress
        method: GET
        description: Retrieve a Civic Address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-locations-location_id
      path: /external_connections/{id}/locations/{location_id}
      operations:
      - name: updatelocation
        method: PATCH
        description: Update a location's static emergency address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the external connection
          required: true
        - name: location_id
          in: path
          type: string
          description: The ID of the location to update
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: external_connections-id-phone_numbers
      path: /external_connections/{id}/phone_numbers
      operations:
      - name: listexternalconnectionphonenumbers
        method: GET
        description: List all phone numbers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-phone_numbers-phone_number_id
      path: /external_connections/{id}/phone_numbers/{phone_number_id}
      operations:
      - name: getexternalconnectionphonenumber
        method: GET
        description: Retrieve a phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateexternalconnectionphonenumber
        method: PATCH
        description: Update a phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: external_connections-id-releases
      path: /external_connections/{id}/releases
      operations:
      - name: listexternalconnectionreleases
        method: GET
        description: List all Releases
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-releases-release_id
      path: /external_connections/{id}/releases/{release_id}
      operations:
      - name: getexternalconnectionrelease
        method: GET
        description: Retrieve a Release request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-uploads
      path: /external_connections/{id}/uploads
      operations:
      - name: listexternalconnectionuploads
        method: GET
        description: List all Upload requests
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createexternalconnectionupload
        method: POST
        description: Creates an Upload request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: external_connections-id-uploads-refresh
      path: /external_connections/{id}/uploads/refresh
      operations:
      - name: refreshexternalconnectionuploads
        method: POST
        description: Refresh the status of all Upload requests
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-uploads-status
      path: /external_connections/{id}/uploads/status
      operations:
      - name: getexternalconnectionuploadsstatus
        method: GET
        description: Get the count of pending upload requests
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-uploads-ticket_id
      path: /external_connections/{id}/uploads/{ticket_id}
      operations:
      - name: getexternalconnectionupload
        method: GET
        description: Retrieve an Upload request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: external_connections-id-uploads-ticket_id-retry
      path: /external_connections/{id}/uploads/{ticket_id}/retry
      operations:
      - name: retryupload
        method: POST
        description: Retry an Upload request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: operator_connect-actions-refresh
      path: /operator_connect/actions/refresh
      operations:
      - name: operatorconnectrefresh
        method: POST
        description: Refresh Operator Connect integration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.TELNYX_API_KEY}}'
  exposes:
  - type: rest
    namespace: telnyx-external-connections-rest
    port: 8080
    description: REST adapter for Telnyx API — External Connections. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/external-connections
      name: external-connections
      description: REST surface for external_connections.
      operations:
      - method: GET
        name: listexternalconnections
        description: List all External Connections
        call: telnyx-external-connections.listexternalconnections
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createexternalconnection
        description: Creates an External Connection
        call: telnyx-external-connections.createexternalconnection
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/log-messages
      name: external-connections-log-messages
      description: REST surface for external_connections-log_messages.
      operations:
      - method: GET
        name: listexternalconnectionlogmessages
        description: List all log messages
        call: telnyx-external-connections.listexternalconnectionlogmessages
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/log-messages/{id}
      name: external-connections-log-messages-id
      description: REST surface for external_connections-log_messages-id.
      operations:
      - method: DELETE
        name: deleteexternalconnectionlogmessage
        description: Dismiss a log message
        call: telnyx-external-connections.deleteexternalconnectionlogmessage
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getexternalconnectionlogmessage
        description: Retrieve a log message
        call: telnyx-external-connections.getexternalconnectionlogmessage
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}
      name: external-connections-id
      description: REST surface for external_connections-id.
      operations:
      - method: DELETE
        name: deleteexternalconnection
        description: Deletes an External Connection
        call: telnyx-external-connections.deleteexternalconnection
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getexternalconnection
        description: Retrieve an External Connection
        call: telnyx-external-connections.getexternalconnection
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateexternalconnection
        description: Update an External Connection
        call: telnyx-external-connections.updateexternalconnection
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/civic-addresses
      name: external-connections-id-civic-addresses
      description: REST surface for external_connections-id-civic_addresses.
      operations:
      - method: GET
        name: listcivicaddresses
        description: List all civic addresses and locations
        call: telnyx-external-connections.listcivicaddresses
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/civic-addresses/{address-id}
      name: external-connections-id-civic-addresses-address-id
      description: REST surface for external_connections-id-civic_addresses-address_id.
      operations:
      - method: GET
        name: getexternalconnectioncivicaddress
        description: Retrieve a Civic Address
        call: telnyx-external-connections.getexternalconnectioncivicaddress
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/locations/{location-id}
      name: external-connections-id-locations-location-id
      description: REST surface for external_connections-id-locations-location_id.
      operations:
      - method: PATCH
        name: updatelocation
        description: Update a location's static emergency address
        call: telnyx-external-connections.updatelocation
        with:
          id: rest.id
          location_id: rest.location_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/phone-numbers
      name: external-connections-id-phone-numbers
      description: REST surface for external_connections-id-phone_numbers.
      operations:
      - method: GET
        name: listexternalconnectionphonenumbers
        description: List all phone numbers
        call: telnyx-external-connections.listexternalconnectionphonenumbers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/phone-numbers/{phone-number-id}
      name: external-connections-id-phone-numbers-phone-number-id
      description: REST surface for external_connections-id-phone_numbers-phone_number_id.
      operations:
      - method: GET
        name: getexternalconnectionphonenumber
        description: Retrieve a phone number
        call: telnyx-external-connections.getexternalconnectionphonenumber
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateexternalconnectionphonenumber
        description: Update a phone number
        call: telnyx-external-connections.updateexternalconnectionphonenumber
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/releases
      name: external-connections-id-releases
      description: REST surface for external_connections-id-releases.
      operations:
      - method: GET
        name: listexternalconnectionreleases
        description: List all Releases
        call: telnyx-external-connections.listexternalconnectionreleases
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/releases/{release-id}
      name: external-connections-id-releases-release-id
      description: REST surface for external_connections-id-releases-release_id.
      operations:
      - method: GET
        name: getexternalconnectionrelease
        description: Retrieve a Release request
        call: telnyx-external-connections.getexternalconnectionrelease
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/uploads
      name: external-connections-id-uploads
      description: REST surface for external_connections-id-uploads.
      operations:
      - method: GET
        name: listexternalconnectionuploads
        description: List all Upload requests
        call: telnyx-external-connections.listexternalconnectionuploads
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createexternalconnectionupload
        description: Creates an Upload request
        call: telnyx-external-connections.createexternalconnectionupload
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/uploads/refresh
      name: external-connections-id-uploads-refresh
      description: REST surface for external_connections-id-uploads-refresh.
      operations:
      - method: POST
        name: refreshexternalconnectionuploads
        description: Refresh the status of all Upload requests
        call: telnyx-external-connections.refreshexternalconnectionuploads
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/uploads/status
      name: external-connections-id-uploads-status
      description: REST surface for external_connections-id-uploads-status.
      operations:
      - method: GET
        name: getexternalconnectionuploadsstatus
        description: Get the count of pending upload requests
        call: telnyx-external-connections.getexternalconnectionuploadsstatus
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/uploads/{ticket-id}
      name: external-connections-id-uploads-ticket-id
      description: REST surface for external_connections-id-uploads-ticket_id.
      operations:
      - method: GET
        name: getexternalconnectionupload
        description: Retrieve an Upload request
        call: telnyx-external-connections.getexternalconnectionupload
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external-connections/{id}/uploads/{ticket-id}/retry
      name: external-connections-id-uploads-ticket-id-retry
      description: REST surface for external_connections-id-uploads-ticket_id-retry.
      operations:
      - method: POST
        name: retryupload
        description: Retry an Upload request
        call: telnyx-external-connections.retryupload
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/operator-connect/actions/refresh
      name: operator-connect-actions-refresh
      description: REST surface for operator_connect-actions-refresh.
      operations:
      - method: POST
        name: operatorconnectrefresh
        description: Refresh Operator Connect integration
        call: telnyx-external-connections.operatorconnectrefresh
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: telnyx-external-connections-mcp
    port: 9090
    transport: http
    description: MCP adapter for Telnyx API — External Connections. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-all-external-connections
      description: List all External Connections
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.listexternalconnections
      outputParameters:
      - type: object
        mapping: $.
    - name: creates-external-connection
      description: Creates an External Connection
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-external-connections.createexternalconnection
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-log-messages
      description: List all log messages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.listexternalconnectionlogmessages
      outputParameters:
      - type: object
        mapping: $.
    - name: dismiss-log-message
      description: Dismiss a log message
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: telnyx-external-connections.deleteexternalconnectionlogmessage
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-log-message
      description: Retrieve a log message
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.getexternalconnectionlogmessage
      outputParameters:
      - type: object
        mapping: $.
    - name: deletes-external-connection
      description: Deletes an External Connection
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: telnyx-external-connections.deleteexternalconnection
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-external-connection
      description: Retrieve an External Connection
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.getexternalconnection
      outputParameters:
      - type: object
        mapping: $.
    - name: update-external-connection
      description: Update an External Connection
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: telnyx-external-connections.updateexternalconnection
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-civic-addresses-and
      description: List all civic addresses and locations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.listcivicaddresses
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-civic-address
      description: Retrieve a Civic Address
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.getexternalconnectioncivicaddress
      outputParameters:
      - type: object
        mapping: $.
    - name: update-location-s-static-emergency-address
      description: Update a location's static emergency address
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: telnyx-external-connections.updatelocation
      with:
        id: tools.id
        location_id: tools.location_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-phone-numbers
      description: List all phone numbers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.listexternalconnectionphonenumbers
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-phone-number
      description: Retrieve a phone number
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.getexternalconnectionphonenumber
      outputParameters:
      - type: object
        mapping: $.
    - name: update-phone-number
      description: Update a phone number
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: telnyx-external-connections.updateexternalconnectionphonenumber
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-releases
      description: List all Releases
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.listexternalconnectionreleases
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-release-request
      description: Retrieve a Release request
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.getexternalconnectionrelease
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-upload-requests
      description: List all Upload requests
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.listexternalconnectionuploads
      outputParameters:
      - type: object
        mapping: $.
    - name: creates-upload-request
      description: Creates an Upload request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-external-connections.createexternalconnectionupload
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: refresh-status-all-upload-requests
      description: Refresh the status of all Upload requests
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-external-connections.refreshexternalconnectionuploads
      outputParameters:
      - type: object
        mapping: $.
    - name: get-count-pending-upload-requests
      description: Get the count of pending upload requests
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.getexternalconnectionuploadsstatus
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-upload-request
      description: Retrieve an Upload request
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-external-connections.getexternalconnectionupload
      outputParameters:
      - type: object
        mapping: $.
    - name: retry-upload-request
      description: Retry an Upload request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-external-connections.retryupload
      outputParameters:
      - type: object
        mapping: $.
    - name: refresh-operator-connect-integration
      description: Refresh Operator Connect integration
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-external-connections.operatorconnectrefresh
      outputParameters:
      - type: object
        mapping: $.