Accounts-account-email-domain-usernames-mailboxName-exchange-action:POST

Jerry.dimitrov (Talk)
(Created page with "{{resetPassword| exchange||resource=exchange|base=/accounts/{account}|base_example=/accounts/account123}}")
Newer edit →

---

POST /accounts/{account}/email/{domain}/usernames/{mailboxName}/exchange/action

Apply an action on exchange mailbox e.g. reset password

Request

POST /accounts/{account}/email/{domain}/usernames/{mailboxName}/exchange/action

Request Parameters

account - string

The user account owning the domain and the exchange mailboxes

domain - string

The specific domain for which the call will retrieve the list

maiboxName - string

The name of the exchange mailbox.

Request Headers

Content-Type

Required. Set this header to application/json; charset=UTF-8

Request Body

{ 
  "action": "resetPassword", 
  "actionData": {
    "secretQuestionsAnswers": {"{tk}": "{answer}"},
    "password": "{password}"
  } 
}
 

action - string

The action that should be performed. Allowed values are:

resetPassword - Reset the password of exchange mailbox.

actionData - dictionary (Required)

Data to be send with the action.

secretQuestionsAnswers - dictionary (Required)

Dictionary of key/value pairs, each of which represents secret question text key/answer pair.

tk - string (Required)

The text key for the secret question. There should be no duplicate text keys per exchange mailbox.

answer - string (Required)

The answer in plain-text - must be at least two characters.

password - string (Required)

The password. The password should be at least 8 characters long, a mix of numbers, symbols and mixed-case letters. It should not begin with "pass", "123", "abc", should not contain the second-level domain name of the service, should not contain the username of the mailbox or start with its first 3 characters. There is a restriction using the same password more than once.

Password validation rules:

Password must not be used more than once

Minimum length 8

Maximum length 128

Should have at least one digit

Should have at least one capital letter

Should have at least one lower case letter

Should contain at least one special character (any character other than lower or uppercase letters, digits and underscore "_" is considered special character)

Should not start with the phrase 'pass' case-insensitively

Should not start with 'abc' case-insensitively

Should not start with 123

Must not contain second-level domain, username or start with the first 3 letters from the username

Response

Expected Response Codes

204 No Content

Success

400 Bad Request

The supplied action or the supplied data is invalid.

404 Not Found

The resource does not exist.

409 Conflict

Validation of the secret answer failed.

Examples

Request password reset of exchange mailbox

Request

POST /accounts/account123/email/test.com/usernames/mailbox123/exchange/action
Content-Type: application/json; Charset=UTF-8

{ 
  "action": "resetPassword",
  "actionData": {
    "secretQuestionsAnswers": {"tk1": "answer123"},
    "password": "pWord123$"
}
 

Response

204 No Content
 

Request password reset of exchange mailbox with wrong answer

Request

POST /accounts/account123/email/test.com/usernames/mailbox123/exchange/action
Content-Type: application/json; Charset=UTF-8

{ 
  "action": "resetPassword",
  "actionData": {
    "secretQuestionsAnswersList": {"tk1": "wrongAnswer"},
    "password": "pWord123$"
}
 

Response

409 Conflict

{
  "conflict": {
    "message": "Invalid secret questions and answers provided",
    "code": 409, 
  }
}
 

See also

• Email API

blog comments powered by Disqus