telnyx-sip-go

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

Telnyx Sip - Go

Installation

go get github.com/team-telnyx/telnyx-go

Setup

import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)

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, err := client.OutboundVoiceProfiles.List(context.TODO(), telnyx.OutboundVoiceProfileListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Create an outbound voice profile

Create an outbound voice profile.

POST /outbound_voice_profiles — Required: name

	outboundVoiceProfile, err := client.OutboundVoiceProfiles.New(context.TODO(), telnyx.OutboundVoiceProfileNewParams{
		Name: "office",
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", outboundVoiceProfile.Data)

Retrieve an outbound voice profile

Retrieves the details of an existing outbound voice profile.

GET /outbound_voice_profiles/{id}

	outboundVoiceProfile, err := client.OutboundVoiceProfiles.Get(context.TODO(), "1293384261075731499")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", outboundVoiceProfile.Data)

Updates an existing outbound voice profile.

PATCH /outbound_voice_profiles/{id} — Required: name

	outboundVoiceProfile, err := client.OutboundVoiceProfiles.Update(
		context.TODO(),
		"1293384261075731499",
		telnyx.OutboundVoiceProfileUpdateParams{
			Name: "office",
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", outboundVoiceProfile.Data)

Delete an outbound voice profile

Deletes an existing outbound voice profile.

DELETE /outbound_voice_profiles/{id}

	outboundVoiceProfile, err := client.OutboundVoiceProfiles.Delete(context.TODO(), "1293384261075731499")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", outboundVoiceProfile.Data)

List connections

Returns a list of your connections irrespective of type.

GET /connections

	page, err := client.Connections.List(context.TODO(), telnyx.ConnectionListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Retrieve a connection

Retrieves the high-level details of an existing connection.

GET /connections/{id}

	connection, err := client.Connections.Get(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", connection.Data)

List credential connections

Returns a list of your credential connections.

GET /credential_connections

	page, err := client.CredentialConnections.List(context.TODO(), telnyx.CredentialConnectionListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Create a credential connection

Creates a credential connection.

POST /credential_connections — Required: user_name, password, connection_name

	credentialConnection, err := client.CredentialConnections.New(context.TODO(), telnyx.CredentialConnectionNewParams{
		ConnectionName: "my name",
		Password:       "my123secure456password789",
		UserName:       "myusername123",
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", credentialConnection.Data)

Retrieve a credential connection

Retrieves the details of an existing credential connection.

GET /credential_connections/{id}

	credentialConnection, err := client.CredentialConnections.Get(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", credentialConnection.Data)

Update a credential connection

Updates settings of an existing credential connection.

PATCH /credential_connections/{id}

	credentialConnection, err := client.CredentialConnections.Update(
		context.TODO(),
		"id",
		telnyx.CredentialConnectionUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", credentialConnection.Data)

Delete a credential connection

Deletes an existing credential connection.

DELETE /credential_connections/{id}

	credentialConnection, err := client.CredentialConnections.Delete(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", credentialConnection.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, err := client.CredentialConnections.Actions.CheckRegistrationStatus(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)

List Ips

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

GET /ips

	page, err := client.IPs.List(context.TODO(), telnyx.IPListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Create an Ip

Create a new IP object.

POST /ips — Required: ip_address

	ip, err := client.IPs.New(context.TODO(), telnyx.IPNewParams{
		IPAddress: "192.168.0.0",
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ip.Data)

Retrieve an Ip

Return the details regarding a specific IP.

GET /ips/{id}

	ip, err := client.IPs.Get(context.TODO(), "6a09cdc3-8948-47f0-aa62-74ac943d6c58")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ip.Data)

Update an Ip

Update the details of a specific IP.

PATCH /ips/{id} — Required: ip_address

	ip, err := client.IPs.Update(
		context.TODO(),
		"6a09cdc3-8948-47f0-aa62-74ac943d6c58",
		telnyx.IPUpdateParams{
			IPAddress: "192.168.0.0",
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ip.Data)

Delete an Ip

Delete an IP.

DELETE /ips/{id}

	ip, err := client.IPs.Delete(context.TODO(), "6a09cdc3-8948-47f0-aa62-74ac943d6c58")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ip.Data)

List Ip connections

Returns a list of your IP connections.

GET /ip_connections

	page, err := client.IPConnections.List(context.TODO(), telnyx.IPConnectionListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Create an Ip connection

Creates an IP connection.

POST /ip_connections

	ipConnection, err := client.IPConnections.New(context.TODO(), telnyx.IPConnectionNewParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ipConnection.Data)

Retrieve an Ip connection

Retrieves the details of an existing ip connection.

GET /ip_connections/{id}

	ipConnection, err := client.IPConnections.Get(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ipConnection.Data)

Update an Ip connection

Updates settings of an existing IP connection.

PATCH /ip_connections/{id}

	ipConnection, err := client.IPConnections.Update(
		context.TODO(),
		"id",
		telnyx.IPConnectionUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ipConnection.Data)

Delete an Ip connection

Deletes an existing IP connection.

DELETE /ip_connections/{id}

	ipConnection, err := client.IPConnections.Delete(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", ipConnection.Data)

List FQDNs

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

GET /fqdns

	page, err := client.Fqdns.List(context.TODO(), telnyx.FqdnListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Create an FQDN

Create a new FQDN object.

POST /fqdns — Required: fqdn, dns_record_type, connection_id

	fqdn, err := client.Fqdns.New(context.TODO(), telnyx.FqdnNewParams{
		ConnectionID:  "1516447646313612565",
		DNSRecordType: "a",
		Fqdn:          "example.com",
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdn.Data)

Retrieve an FQDN

Return the details regarding a specific FQDN.

GET /fqdns/{id}

	fqdn, err := client.Fqdns.Get(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdn.Data)

Update an FQDN

Update the details of a specific FQDN.

PATCH /fqdns/{id}

	fqdn, err := client.Fqdns.Update(
		context.TODO(),
		"id",
		telnyx.FqdnUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdn.Data)

Delete an FQDN

Delete an FQDN.

DELETE /fqdns/{id}

	fqdn, err := client.Fqdns.Delete(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdn.Data)

List FQDN connections

Returns a list of your FQDN connections.

GET /fqdn_connections

	page, err := client.FqdnConnections.List(context.TODO(), telnyx.FqdnConnectionListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Create an FQDN connection

Creates a FQDN connection.

POST /fqdn_connections — Required: connection_name

	fqdnConnection, err := client.FqdnConnections.New(context.TODO(), telnyx.FqdnConnectionNewParams{
		ConnectionName: "string",
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdnConnection.Data)

Retrieve an FQDN connection

Retrieves the details of an existing FQDN connection.

GET /fqdn_connections/{id}

	fqdnConnection, err := client.FqdnConnections.Get(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdnConnection.Data)

Update an FQDN connection

Updates settings of an existing FQDN connection.

PATCH /fqdn_connections/{id}

	fqdnConnection, err := client.FqdnConnections.Update(
		context.TODO(),
		"id",
		telnyx.FqdnConnectionUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdnConnection.Data)

Delete an FQDN connection

Deletes an FQDN connection.

DELETE /fqdn_connections/{id}

	fqdnConnection, err := client.FqdnConnections.Delete(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", fqdnConnection.Data)

List Mobile Voice Connections

GET /v2/mobile_voice_connections

	page, err := client.MobileVoiceConnections.List(context.TODO(), telnyx.MobileVoiceConnectionListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)

Create a Mobile Voice Connection

POST /v2/mobile_voice_connections

	mobileVoiceConnection, err := client.MobileVoiceConnections.New(context.TODO(), telnyx.MobileVoiceConnectionNewParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", mobileVoiceConnection.Data)

Retrieve a Mobile Voice Connection

GET /v2/mobile_voice_connections/{id}

	mobileVoiceConnection, err := client.MobileVoiceConnections.Get(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", mobileVoiceConnection.Data)

Update a Mobile Voice Connection

PATCH /v2/mobile_voice_connections/{id}

	mobileVoiceConnection, err := client.MobileVoiceConnections.Update(
		context.TODO(),
		"id",
		telnyx.MobileVoiceConnectionUpdateParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", mobileVoiceConnection.Data)

Delete a Mobile Voice Connection

DELETE /v2/mobile_voice_connections/{id}

	mobileVoiceConnection, err := client.MobileVoiceConnections.Delete(context.TODO(), "id")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", mobileVoiceConnection.Data)