matrix-org / matrix-org/matrix-spec

`/turnServer` doesn't specify error when homeserver has no TURN server

Open
#1,795 0 comments 0 reactions 0 assignees View on GitHub
clarification
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

## Link to problem area:
https://spec.matrix.org/v1.10/client-server-api/#get_matrixclientv3voipturnserver
## Issue
In the spec, it does not tell homeservers what to respond with for requests to `/voip/turnServer` when there is no TURN server configured. Currently:
- Synapse and Dendrite return `200 OK` with an empty body.
- Conduit and Construct return empty strings for `username` and `password`, and an empty array for `uris`.
- Telodendria does not support this endpoint yet.

What would be the correct behavior? The empty body, an (`M_NOT_FOUND`) error code, or something else?

Contributor guide

Open the contributing guide

Research direction

Start with the linked Matrix Client-Server API section for GET /_matrix/client/v3/voip/turnServer and compare the response behaviors listed for Synapse, Dendrite, Conduit, and Construct. Done means reaching and documenting an agreed response for homeservers without a configured TURN server.

Written by the indexing model from the issue text.

Assessment

Domain
api, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.