Files
NodeBB/public/openapi/write/users/uid/emails/email.yaml
Julian Lam d098e26f82 User Email and email validation API (#10160)
* feat: wip user emails api

* fix: allow admins with manage-users access to email confirmation api as well

* fix: wrong route path

* docs: openapi spec
2022-01-21 11:20:39 -05:00

25 lines
751 B
YAML

get:
tags:
- users
summary: get user's email data
description: |
This operation lists the data associated with a single email.
This route is accessible to all users if the target user has elected to show their email publicly. Otherwise, it is only accessible to privileged users, or if the calling user is the same as the target user.
parameters:
- in: path
required: true
name: uid
schema:
type: number
description: A valid user id
example: 1
- in: path
required: true
name: email
schema:
type: string
description: A valid email address
example: test@example.org
responses:
'204':
description: user's email data successfully retrieved