Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Call Handling Rules

Update Call Handling Rule

Updates a custom call handling rule for a particular caller ID.

put/restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

ruleIdstring required

Internal identifier of a call handling rule

Request body

idstring

Identifier of an answering rule

enabledboolean

Specifies if the rule is active or inactive. The default value is true

namestring

Name of an answering rule specified by user

callHandlingAction'ForwardCalls' | 'UnconditionalForwarding' | 'AgentQueue' | 'TransferToExtension' | 'TakeMessagesOnly' | 'PlayAnnouncementOnly' | 'SharedLines'

Specifies how incoming calls are forwarded

type'BusinessHours' | 'AfterHours' | 'Custom'

Type of an answering rule

screening'Off' | 'NoCallerId' | 'UnknownCallerId' | 'Always'

Call screening status. 'Off' - no call screening; 'NoCallerId'

  • if caller ID is missing, then callers are asked to say their name before connecting; 'UnknownCallerId' - if caller ID is not in contact list, then callers are asked to say their name before connecting; 'Always' - the callers are always asked to say their name before connecting. The default value is 'Off'
showInactiveNumbersboolean

Indicates whether inactive numbers should be returned or not

Response

OK

uristring uri

Canonical URI to an answering rule resource

idstring

Internal identifier of an answering rule

type'BusinessHours' | 'AfterHours' | 'Custom'

Type of an answering rule

namestring

Name of an answering rule specified by user

enabledboolean

Specifies if an answering rule is active or inactive

callHandlingAction'ForwardCalls' | 'UnconditionalForwarding' | 'AgentQueue' | 'TransferToExtension' | 'TakeMessagesOnly' | 'PlayAnnouncementOnly' | 'SharedLines'

Specifies how incoming calls are forwarded

screening'Off' | 'NoCallerId' | 'UnknownCallerId' | 'Always'

Call screening status. 'Off' - no call screening; 'NoCallerId' - if caller ID is missing, then callers are asked to say their name before connecting; 'UnknownCallerId' - if caller ID is not in contact list, then callers are asked to say their name before connecting; 'Always' - the callers are always asked to say their name before connecting. The default value is 'Off'