> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete SIP Registration

> Remove SIP registration data from an agent, unregistering it from the PBX

## Path Parameters

<ParamField path="agentId" type="string" required>
  The unique identifier of the agent (UUID format)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/sip/registration \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const agentId = '123e4567-e89b-12d3-a456-426614174000';

  const response = await fetch(
    `https://api.telzino.com/v1/agents/${agentId}/sip/registration`,
    {
      method: 'DELETE',
      headers: {
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
      }
    }
  );

  const result = await response.json();
  ```

  ```python Python theme={null}
  import requests

  agent_id = '123e4567-e89b-12d3-a456-426614174000'

  response = requests.delete(
      f'https://api.telzino.com/v1/agents/{agent_id}/sip/registration',
      headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
  )

  result = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true
  }
  ```

  ```json 401 theme={null}
  {
    "error": "unauthorized",
    "error_description": "User payload not found"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "forbidden",
    "error_description": "Cannot update vida agents via this API"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "not_found",
    "error_description": "Agent not found or access denied"
  }
  ```
</ResponseExample>

## What Happens

1. The agent's `sip_registration_data` is set to `null`
2. The sync service detects the change and **unregisters** the agent from OpenSIPS
3. The agent will **stop receiving** inbound SIP calls

<Warning>
  This action is immediate. The agent will stop receiving calls as soon as the sync service processes the change. To re-enable SIP registration, use the [Set SIP Registration](/api-reference/agents/sip-registration) endpoint.
</Warning>