> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qumo-deploy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# client.relays

> Where the clients of a broadcast path connect.

Where the clients of a broadcast path connect.

Reach it as `client.relays` on a [`QumoClient`](https://docs.qumo-deploy.com/sdk/reference/client#qumoclient).

### place

```ts theme={null}
place(params: PlaceRelaysParams, options?: { signal?: AbortSignal }): Promise<RelayPlacement>
```

Returns the relays a client of a broadcast path should connect to, best
first. It needs no token or session, so an app that signs its own
credentials can call it from the client that is about to connect: the
region nearest that client then comes first.

The order is a first guess from geography, not a measurement. Try the
relays in order and move to the next when one does not answer; a client
that can time its connections may prefer the fastest. Whichever relay a
publisher and a viewer end up on, the broadcast reaches the viewer: the
managed relays pass it between themselves.

This throws when the control plane does not answer. To connect whether
or not it does, use [`RelaysResource.resolve`](https://docs.qumo-deploy.com/sdk/reference/relays#resolve).

Types: [`PlaceRelaysParams`](https://docs.qumo-deploy.com/sdk/reference/types#placerelaysparams), [`RelayPlacement`](https://docs.qumo-deploy.com/sdk/reference/types#relayplacement)

### resolve

```ts theme={null}
resolve(params: ResolveRelaysParams): Promise<string[]>
```

Returns the relay addresses (`host:port`) a client should try, in order,
and always returns some: discovery is optional, the hostname is not.

It asks [`RelaysResource.place`](https://docs.qumo-deploy.com/sdk/reference/relays#place) for the relays nearest the client and
ends the list with `hostname`. When discovery fails, answers an error or
takes longer than `timeoutMs`, the list is `hostname` alone. A session
never needs the control plane to be reachable, only DNS.

Types: [`ResolveRelaysParams`](https://docs.qumo-deploy.com/sdk/reference/types#resolverelaysparams)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.