Revision as of 15:24, 15 November 2013

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

Upgrades/downgrades OpenXchange account type.

Request

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

URI Parameters

domain - string

mailboxName - string

Request Headers

Authorization - HTTP Authorization header [1]

Use the mailbox owner credentials for the specific mailbox, e.g. username: email@domain.com, password: secret

Content-Type

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

Request Body

{
    "type": "{type}",
    "allowUpgrade": {allowUpgrade}
}
 

Parameters

allowUpgrade - boolean

OpenXchange allowUpgrade option value

type - string - one of "standard", "activesync" or "premium"

OpenXchange account type. Valid values are standard, activesync, premium. Required.

If allowUpgrade is set to false providing a type different than standard results in a 400 Bad Request response

If type is already different than standard and allowUpgrade is set to false the response is 400 Bad Request

Response

Status Code

204 No Content

Success

400 Bad Request

The format of the request body is invalid or the username does not meet the requirements.

401 Unauthorized

The supplied credentials are invalid or do not provide permissions for this operation.

404 Not Found

The domain name does not exist.

Examples

Failure updating account type with empty type

Request

PUT /email/test.com/usernames/john.smith/webmail

{"type": ""}
 

Response

400 Bad Request

{"type": "Required"}
 

Failure updating account type with invalid type

Request

PUT /email/test.com/usernames/john.smith/webmail

{"type": "invalid-type"}
 

Response

400 Bad Request

{"type": "\"invalid-type\" is not one of standard, activesync, premium"}
 

Failure using inconsistent combination of allowUpgrade and type

Request

PUT /email/test.com/usernames/john.smith/webmail

{"type": "premium", "allowUpgrade": false}
 

Response

400 Bad Request

{"message": "The allowUpgrade option is inconsistent with the provided type"}
 

Failure changing the allowUpgrade option for activesync or premium accounts

Request

PUT /email/test.com/usernames/john.smith/webmail

{"allowUpgrade": false}
 

Response

400 Bad Request

{"message": "The account is already upgraded. Please downgrade it to standard first."}
 

Failure when upgrading the account while allowUpgrade is set to false

Request

PUT /email/test.com/usernames/john.smith/webmail

{"type": "premium"}
 

Response

400 Bad Request

{"message": "This account is not allowed to be upgraded"}
 

Success updating account type

Request

PUT /email/test.com/usernames/john.smith/webmail

{"type": "premium"}
 

Response

204 No Content