Skip to content

docs(teslemetry): correct find_authorized_clients reliability claim #82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Bre77 merged 1 commit into from
Jul 16, 2026
Merged

docs(teslemetry): correct find_authorized_clients reliability claim #82

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/teslemetry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -558,10 +558,10 @@ never mistaken for "no authorized clients". `state` is typed as
`AuthorizedClientState`. The raw response is still available on `raw` for
anything not modeled.

Use these cloud helpers only as secondary, best-effort checks during local key
pairing. They are not authoritative verification that a key can make signed
LAN requests; the reliable proof is a successful signed local read through the
paired client, as shown in [Energy: Local Control](energy_local_control.md).
These cloud helpers report the gateway's registered-client state as returned
by the Teslemetry API. Confirming that a key can actually make signed LAN
requests requires a successful signed local read through the paired client,
as shown in [Energy: Local Control](energy_local_control.md).

```python
async def main():
Expand Down
7 changes: 2 additions & 5 deletions tesla_fleet_api/teslemetry/energysite.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -324,11 +324,8 @@ async def find_authorized_clients(self) -> AuthorizedClients:
caller. Raises
:class:`~tesla_fleet_api.exceptions.InvalidResponse` on a null
response body or an unrecognized response shape rather than
treating either as "no clients". Treat it as a secondary,
best-effort cloud check during local key pairing; a successful
signed local read through the paired LAN client is the
authoritative verification. See :class:`AuthorizedClients` for the
exact parsing semantics.
treating either as "no clients". See :class:`AuthorizedClients` for
the exact parsing semantics.
"""
return _parse_authorized_clients(await self.list_authorized_clients())

Expand Down
Loading