Agent inbound links

List agent inbound links

Returns every agent↔inbound-trunk link in the workspace tied to your API key. A link is what makes an agent answer calls arriving on a SIP inbound trunk. The relationship is many-to-many: one trunk can carry several agents, and one agent can serve several trunks. Each item carries the link_id you need to remove it later via DELETE /api/ext/agent-inbound-link/{link_id}.

GET

https://api.nabrah.ai/api/ext/agent-inbound-link

curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/agent-inbound-link' \
  --header 'X-API-Key: <your-api-key>'

{
  "links": [
    {
      "link_id": "00000000-0000-4000-8000-000000000000",
      "agent": {
        "agent_id": "00000000-0000-4000-8000-000000000000",
        "name": "string"
      },
      "sip_inbound": {
        "id": "00000000-0000-4000-8000-000000000000",
        "numbers": "string"
      },
      "project_id": "00000000-0000-4000-8000-000000000000",
      "created_at": "2026-01-15T12:00:00.000Z"
    }
  ]
}

What each item contains

link_id

The identifier of the association itself — not the agent and not the trunk. Pass it to DELETE /api/ext/agent-inbound-link/{link_id} to de-link.

link_id

agent and sip_inbound

agent echoes the linked agent's agent_id and name; sip_inbound echoes the trunk's id and its numbers string. Use these to tell links apart without extra lookups.

agentsip_inbound

Scope

Workspace only

Only links belonging to the workspace behind your API key are returned. There is no pagination — the full list comes back in one response.

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Response

200

Successful Response

application/json