Email-domain-usernames-mailboxName-secrets:PUT

From Hostway API Documentation
Revision as of 06:28, 2 September 2014 by Dinh.anh (Talk)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

PUT /email/{domain}/usernames/{mailboxName}/secrets

Set or update all secret questions and answers for mailbox(alias).

Contents


Request

PUT /email/{domain}/usernames/{mailboxName}/secrets

Request Parameters

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 at least three pairs of secret questions and answers required.
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 /email/test.com/usernames/test-mailbox/secrets

{
    "tk1": "answer1",
    "tk2": "answer2",
    "tk3": "answer3"
}
 

Response

204 No Content
 

Set only two secret questions and answers

Request

PUT /email/test.com/usernames/test-mailbox/secrets

{
    "tk1": "answer1",
    "tk2": "answer2"
}
 

Response

400 Bad Request

"details": {"": "Shorter than minimum length 3"}
 

See also


blog comments powered by Disqus

Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox