telnyx-sip-python

name	telnyx-sip-python
description	Configure SIP trunking connections and outbound voice profiles. Use when connecting PBX systems or managing SIP infrastructure. This skill provides Python SDK examples.
metadata	{"author":"telnyx","product":"sip","language":"python","generated_by":"telnyx-ext-skills-generator"}

Telnyx Sip - Python

Installation

pip install telnyx

Setup

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)

All examples below assume client is already initialized as shown above.

Get all outbound voice profiles

Get all outbound voice profiles belonging to the user that match the given filters.

GET /outbound_voice_profiles

page = client.outbound_voice_profiles.list()
page = page.data[0]
print(page.id)

Create an outbound voice profile

Create an outbound voice profile.

POST /outbound_voice_profiles — Required: name

outbound_voice_profile = client.outbound_voice_profiles.create(
    name="office",
)
print(outbound_voice_profile.data)

Retrieve an outbound voice profile

Retrieves the details of an existing outbound voice profile.

GET /outbound_voice_profiles/{id}

outbound_voice_profile = client.outbound_voice_profiles.retrieve(
    "1293384261075731499",
)
print(outbound_voice_profile.data)

Updates an existing outbound voice profile.

PATCH /outbound_voice_profiles/{id} — Required: name

outbound_voice_profile = client.outbound_voice_profiles.update(
    id="1293384261075731499",
    name="office",
)
print(outbound_voice_profile.data)

Delete an outbound voice profile

Deletes an existing outbound voice profile.

DELETE /outbound_voice_profiles/{id}

outbound_voice_profile = client.outbound_voice_profiles.delete(
    "1293384261075731499",
)
print(outbound_voice_profile.data)

List connections

Returns a list of your connections irrespective of type.

GET /connections

page = client.connections.list()
page = page.data[0]
print(page.id)

Retrieve a connection

Retrieves the high-level details of an existing connection.

GET /connections/{id}

connection = client.connections.retrieve(
    "id",
)
print(connection.data)

List credential connections

Returns a list of your credential connections.

GET /credential_connections

page = client.credential_connections.list()
page = page.data[0]
print(page.id)

Create a credential connection

Creates a credential connection.

POST /credential_connections — Required: user_name, password, connection_name

credential_connection = client.credential_connections.create(
    connection_name="my name",
    password="my123secure456password789",
    user_name="myusername123",
)
print(credential_connection.data)

Retrieve a credential connection

Retrieves the details of an existing credential connection.

GET /credential_connections/{id}

credential_connection = client.credential_connections.retrieve(
    "id",
)
print(credential_connection.data)

Update a credential connection

Updates settings of an existing credential connection.

PATCH /credential_connections/{id}

credential_connection = client.credential_connections.update(
    id="id",
)
print(credential_connection.data)

Delete a credential connection

Deletes an existing credential connection.

DELETE /credential_connections/{id}

credential_connection = client.credential_connections.delete(
    "id",
)
print(credential_connection.data)

Check a Credential Connection Registration Status

Checks the registration_status for a credential connection, (registration_status) as well as the timestamp for the last SIP registration event (registration_status_updated_at)

POST /credential_connections/{id}/actions/check_registration_status

response = client.credential_connections.actions.check_registration_status(
    "id",
)
print(response.data)

List Ips

Get all IPs belonging to the user that match the given filters.

GET /ips

page = client.ips.list()
page = page.data[0]
print(page.id)

Create an Ip

Create a new IP object.

POST /ips — Required: ip_address

ip = client.ips.create(
    ip_address="192.168.0.0",
)
print(ip.data)

Retrieve an Ip

Return the details regarding a specific IP.

GET /ips/{id}

ip = client.ips.retrieve(
    "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
)
print(ip.data)

Update an Ip

Update the details of a specific IP.

PATCH /ips/{id} — Required: ip_address

ip = client.ips.update(
    id="6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    ip_address="192.168.0.0",
)
print(ip.data)

Delete an Ip

Delete an IP.

DELETE /ips/{id}

ip = client.ips.delete(
    "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
)
print(ip.data)

List Ip connections

Returns a list of your IP connections.

GET /ip_connections

page = client.ip_connections.list()
page = page.data[0]
print(page.id)

Create an Ip connection

Creates an IP connection.

POST /ip_connections

ip_connection = client.ip_connections.create()
print(ip_connection.data)

Retrieve an Ip connection

Retrieves the details of an existing ip connection.

GET /ip_connections/{id}

ip_connection = client.ip_connections.retrieve(
    "id",
)
print(ip_connection.data)

Update an Ip connection

Updates settings of an existing IP connection.

PATCH /ip_connections/{id}

ip_connection = client.ip_connections.update(
    id="id",
)
print(ip_connection.data)

Delete an Ip connection

Deletes an existing IP connection.

DELETE /ip_connections/{id}

ip_connection = client.ip_connections.delete(
    "id",
)
print(ip_connection.data)

List FQDNs

Get all FQDNs belonging to the user that match the given filters.

GET /fqdns

page = client.fqdns.list()
page = page.data[0]
print(page.id)

Create an FQDN

Create a new FQDN object.

POST /fqdns — Required: fqdn, dns_record_type, connection_id

fqdn = client.fqdns.create(
    connection_id="1516447646313612565",
    dns_record_type="a",
    fqdn="example.com",
)
print(fqdn.data)

Retrieve an FQDN

Return the details regarding a specific FQDN.

GET /fqdns/{id}

fqdn = client.fqdns.retrieve(
    "id",
)
print(fqdn.data)

Update an FQDN

Update the details of a specific FQDN.

PATCH /fqdns/{id}

fqdn = client.fqdns.update(
    id="id",
)
print(fqdn.data)

Delete an FQDN

Delete an FQDN.

DELETE /fqdns/{id}

fqdn = client.fqdns.delete(
    "id",
)
print(fqdn.data)

List FQDN connections

Returns a list of your FQDN connections.

GET /fqdn_connections

page = client.fqdn_connections.list()
page = page.data[0]
print(page.id)

Create an FQDN connection

Creates a FQDN connection.

POST /fqdn_connections — Required: connection_name

fqdn_connection = client.fqdn_connections.create(
    connection_name="string",
)
print(fqdn_connection.data)

Retrieve an FQDN connection

Retrieves the details of an existing FQDN connection.

GET /fqdn_connections/{id}

fqdn_connection = client.fqdn_connections.retrieve(
    "id",
)
print(fqdn_connection.data)

Update an FQDN connection

Updates settings of an existing FQDN connection.

PATCH /fqdn_connections/{id}

fqdn_connection = client.fqdn_connections.update(
    id="id",
)
print(fqdn_connection.data)

Delete an FQDN connection

Deletes an FQDN connection.

DELETE /fqdn_connections/{id}

fqdn_connection = client.fqdn_connections.delete(
    "id",
)
print(fqdn_connection.data)

List Mobile Voice Connections

GET /v2/mobile_voice_connections

page = client.mobile_voice_connections.list()
page = page.data[0]
print(page.id)

Create a Mobile Voice Connection

POST /v2/mobile_voice_connections

mobile_voice_connection = client.mobile_voice_connections.create()
print(mobile_voice_connection.data)

Retrieve a Mobile Voice Connection

GET /v2/mobile_voice_connections/{id}

mobile_voice_connection = client.mobile_voice_connections.retrieve(
    "id",
)
print(mobile_voice_connection.data)

Update a Mobile Voice Connection

PATCH /v2/mobile_voice_connections/{id}

mobile_voice_connection = client.mobile_voice_connections.update(
    id="id",
)
print(mobile_voice_connection.data)

Delete a Mobile Voice Connection

DELETE /v2/mobile_voice_connections/{id}

mobile_voice_connection = client.mobile_voice_connections.delete(
    "id",
)
print(mobile_voice_connection.data)