Skip to content
Linq Copy agent prompt

Sip Profiles

SIP configuration

Your Linq representative provides the signaling and media IP ranges and ports to allow through your firewall during onboarding.

Set primary_uri to your endpoint as scheme + host — sips: for TLS or sip: for UDP, with no user part (we add it). Each call arrives at your endpoint as:

sip:<called-number>@<your-host>

so you can route on the dialed number. The caller’s number is in the From header in E.164.

Create a SIP profile
sip_profiles.create(SipProfileCreateParams**kwargs) -> SipProfile
POST/v3/sip-profiles
List SIP profiles
sip_profiles.list() -> SipProfileListResponse
GET/v3/sip-profiles
Get a SIP profile by ID
sip_profiles.retrieve(strsip_profile_id) -> SipProfile
GET/v3/sip-profiles/{sipProfileId}
Update a SIP profile
sip_profiles.update(strsip_profile_id, SipProfileUpdateParams**kwargs) -> SipProfile
PUT/v3/sip-profiles/{sipProfileId}
Delete a SIP profile
sip_profiles.delete(strsip_profile_id)
DELETE/v3/sip-profiles/{sipProfileId}
Assign or clear a phone number's SIP profile
sip_profiles.assign(strphone_number, SipProfileAssignParams**kwargs) -> SipProfileAssignResponse
PUT/v3/phone-numbers/{phoneNumber}/sip-profile
ModelsExpand Collapse
class SipProfile: …
id: str

Unique identifier for the SIP profile

assigned_number_count: int

How many phone numbers reference this profile

created_at: datetime
formatdate-time
name: str

Human-readable name

primary_uri: str

Your SIP endpoint as scheme + host (sip: UDP / sips: TLS); no user part — we set it to the called number on each call.

updated_at: datetime
formatdate-time
version: int

Monotonic version, incremented on each update

backup_uri: Optional[str]

Optional failover SIP URI. Null when unset.

class SipProfileListResponse: …
sip_profiles: List[SipProfile]

The partner’s SIP profiles

id: str

Unique identifier for the SIP profile

assigned_number_count: int

How many phone numbers reference this profile

created_at: datetime
formatdate-time
name: str

Human-readable name

primary_uri: str

Your SIP endpoint as scheme + host (sip: UDP / sips: TLS); no user part — we set it to the called number on each call.

updated_at: datetime
formatdate-time
version: int

Monotonic version, incremented on each update

backup_uri: Optional[str]

Optional failover SIP URI. Null when unset.

class SipProfileAssignResponse: …
phone_number: str

The phone number whose assignment changed

sip_profile_id: Optional[str]

The assigned SIP profile id, or null when cleared