pass_

Decline control of an inbound call, returning it to the SignalWire routing engine. The call is not ended — it continues to ring and may be delivered to another Relay client or routing rule.

The method is named pass_() with a trailing underscore because pass is a reserved keyword in Python.

Parameters

None.

Returns

dict — Server response confirming the pass operation.

Example

from signalwire.relay import RelayClient
client = RelayClient(
    project="your-project-id",
    token="your-api-token",
    contexts=["default"],
)
@client.on_call
async def handle_call(call):
    # Only handle calls from a specific context
    if call.context != "sales":
        await call.pass_()
        print("Call passed back to routing")
        return
    await call.answer()
client.run()