PUT user/…/email-addresses/…/verify/…
Verifies a user's email address by submitting a previously emailed code.
Having a verified email address is a prerequisite for some use cases.
Resource URL
https://www.drillster.com/api/2.1.1/user/{user_id}/email-address/{email}/verify/{nonce}
Parameters
| Field | Description |
|---|---|
user_idrequired |
The user ID of the user to retrieve details for. To retrieve the details of the own user account, the value self may be used as well.Example value: 7OuHq-RcQO_snGWR58TnBw |
emailrequired |
The email address to verify. The email address must be linked to the given user account. Example value: john%40example.com |
noncerequired |
The random based verification code that the user has received in an email message. Example value: a73c-71ca-ffd3-88c0 |
If a PUT request has no body (i.e. the body is empty), it is still mandatory to include a Content-Length header (i.e.
Content-Length: 0). Not all HTTP clients do this automatically. For more information, please see RFC 2616.
Response
An HTTP 204 (No content) response indicating that the verification code was accepted and that the email address is now considered as verified.
Error responses
The following error situations are possible:
| ID | Response code | Description |
|---|---|---|
not_found |
404 (Not found) | Requested account was not found |
not_permitted |
403 (Forbidden) | Caller does not have access to account |
email_not_verified |
400 (Bad request) | The email address could not be verified and as a result the account is still only partially funtional |
Last updated on