matrix-org / matrix-org/matrix-spec
`next_link` on `POST /account/password/email/requestToken` is awkward
- Dominant language
- HTML
- Stars
- 330
- Forks
- 150
- Avg merge
- 2h 21m
- Merged PRs (30d)
- 3
Description
**Link to problem area**: https://spec.matrix.org/unstable/client-server-api/#post_matrixclientv3accountpasswordemailrequesttoken
**Issue**
https://matrix.to/#/!NasysSDfxKxZBzJJoE:matrix.org/$zcgp3rNQPQajiz0bsPhUYE7JypVy_ruQVPOcZ_Qqu04?via=matrix.org&via=libera.chat&via=envs.net
> What is the next_link used for in this: https://spec.matrix.org/unstable/client-server-api/#post_matrixclientv3accountpasswordemailrequesttoken ?
>
> Isn't that always a POST, so it is always ignored?
> empirically it is not ignored :/
> But I guess I should just ignore it for now?
> (The email registration part during UIA could really use some graphs)
> yeah :/
Contributor guide
Research direction
Read the linked Client-Server API section for POST /account/password/email/requestToken and review the linked Matrix discussion about next_link and email registration during UIA. Clarify the intended behavior and update the specification so the purpose and handling of next_link are unambiguous.
Written by the indexing model from the issue text.
Assessment
- Domain
- api, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100