[field-notes] Document account lifecycle endpoints (api/users) + refreshtoken-is-not-a-session-refresh warning #70

Closed
opened 2026-09-09 14:13:08 +00:00 by mat · 0 comments
Owner

Roadmap section: 2.4 Endpoints missing from the notes

  • Account lifecycle (base api/users): POST /{email}/forgottenpasswd; PUT /{email}/forgottenpasswd/{token} with {password: <salted sha256>}; PUT /{email}/token/{token}; PUT /{id}/updateemail; POST / (register); PUT|DELETE /{id}; GET /{email}/isReadyForSiteInstallation (403 for END_USER). Also worth an explicit warning: GET /api/users/{id}/refreshtoken is not a session refresh — it re-sends the activation mail (412 user.already.activated on an active account).

From the 2026-09 re-exploration lineage of energy.comwatt.com (reverse-engineered as END_USER against SPA bundle main.5d426c11.js, live-probed 2026-08-15; no official API exists). Re-verify against the live API before relying on any claim. Migrated from ROADMAP.md when it was retired.

**Roadmap section: 2.4 Endpoints missing from the notes** - **Account lifecycle** (base `api/users`): `POST /{email}/forgottenpasswd`; `PUT /{email}/forgottenpasswd/{token}` with `{password: <salted sha256>}`; `PUT /{email}/token/{token}`; `PUT /{id}/updateemail`; `POST /` (register); `PUT|DELETE /{id}`; `GET /{email}/isReadyForSiteInstallation` (403 for `END_USER`). Also worth an explicit warning: **`GET /api/users/{id}/refreshtoken` is not a session refresh** — it re-sends the activation mail (`412 user.already.activated` on an active account). --- *From the 2026-09 re-exploration lineage of `energy.comwatt.com` (reverse-engineered as `END_USER` against SPA bundle `main.5d426c11.js`, live-probed 2026-08-15; no official API exists). Re-verify against the live API before relying on any claim. Migrated from `ROADMAP.md` when it was retired.*
mat closed this issue 2026-10-11 11:15:47 +00:00
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
mat/python-comwatt-client#70
No description provided.