reject

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

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

Auto-reject calls during do-not-disturb

incomingCall.status$.subscribe((status) => {
  if (status === 'ringing' && userIsBusy()) {
    incomingCall.reject();
  }
});

See

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