sip:decline

The sip:decline action rejects an incoming call with a specific status and, optionally, a reason and SIP headers to include in the response.

This action must be the first and only action returned in the JSON payload for an incoming call.

The sip:decline action is a non-blocking action, and the session ends immediately after it’s executed.

{
  "verb": "sip:decline",
  "status": 480,
  "reason": "Gone Fishing",
  "headers": {
    "Retry-After": 1800
  }
}

You can use the following attributes with the sip:decline action:

Option	Description	Required
`status`	A valid SIP status code in the range 4XX – 6XX.	Yes
`reason`	A brief description.	No (default: the well-known SIP reasons associated with the specified status code)
`headers`	SIP headers to include in the response.	No

Ready To Get Started?