reject

1
reject(): void

Declines an inbound call before it is answered. The caller-side rings stop, no media is negotiated, and the call instance transitions to disconnected. Call reject only on inbound calls in the ringing state; calling it after answer has no effect — use hangup instead to end a connected call.

Returns

void

Examples

Reject from a UI button

1
declineButton.addEventListener('click', () => {
2
  call.reject();
3
});

Auto-reject calls during do-not-disturb

1
incomingCall.status$.subscribe((status) => {
2
  if (status === 'ringing' && userIsBusy()) {
3
    incomingCall.reject();
4
  }
5
});

See

• answer to accept the call instead.
• hangup to end a call that’s already connected.
• answered$ emits false after rejection.