Accounts-account-email-domain-usernames-mailboxName-secrets:PUT
From Hostway API Documentation
(Difference between revisions)
Mike.robski (Talk | contribs) m (1 revision: Release 99) |
Mike.robski (Talk | contribs) m (1 revision: Release 101) |
||
| (One intermediate revision by one user not shown) | |||
| Line 44: | Line 44: | ||
; 400 Bad Request | ; 400 Bad Request | ||
| − | : The format of the request body is invalid or | + | : The format of the request body is invalid or the number of the secret questions and answers pairs in the request is lower then the [[Email-secretQuestionSettings:GET|required minimum]]. |
; 401 Unauthorized | ; 401 Unauthorized | ||
| Line 74: | Line 74: | ||
</nowiki> | </nowiki> | ||
| − | === Set only two secret questions and answers === | + | === Set only two secret questions and answers, when the minimum required is three === |
'''Request''' | '''Request''' | ||
<nowiki> | <nowiki> | ||
Latest revision as of 22:50, 16 December 2014
PUT /accounts/{account}/email/{domain}/usernames/{maiboxName}/secrets
Set or update all secret questions and answers for mailbox(alias).
Contents |
Request
PUT /accounts/{account}/email/{domain}/usernames/{maiboxName}/secrets
Request Parameters
- account - string
- The user account owning the domain and the mailboxes
- domain - string
- The specific mailbox domain
- maiboxName - string
- The name of the mailbox
Request Body
{
"{tk}": "{answer}",
"{tk}": "{answer}",
...
}
Parameters
- tk - string (Required)
- The text key for the secret question. There should be no duplicate text keys per mailbox.
- answer - string (Required)
- The answer in plain-text - must be at least two characters.
Request Headers
- Authorization - HTTP Authorization header [1]
- The Authentication credentials of the client application.
- Content-Type
- Required. Set this header to
application/json; charset=UTF-8
Response
Status Code
- 204 No Content
- Success
- 400 Bad Request
- The format of the request body is invalid or the number of the secret questions and answers pairs in the request is lower then the required minimum.
- 401 Unauthorized
- The supplied credentials are invalid.
- 403 Forbidden
- The authorized user does not have permissions for this operation.
- 404 Not Found
- The domain name, mailbox or account does not exist.
Examples
Success scenario
Request
PUT /accounts/test-account123/email/test.com/usernames/test-mailbox/secrets
{
"tk1": "answer1",
"tk2": "answer2",
"tk3": "answer3"
}
Response
204 No Content
Set only two secret questions and answers, when the minimum required is three
Request
PUT /accounts/test-account123/email/test.com/usernames/test-mailbox/secrets
{
"tk1": "answer1",
"tk2": "answer2"
}
Response
400 Bad Request
"details": {"": "Shorter than minimum length 3"}
See also
