Latest revision as of 23:58, 1 July 2014

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

Gets OpenXchange account type.

Request

GET /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

Response

Status Code

200 OK

Success

401 Unauthorized

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

404 Not Found

The domain name does not exist.

Response Body

{
   "type": "{type}",
   "allowUpgrade": {allowUpgrade},
   "theme": "{theme}",
   "language": "{language}",
   "timezone": "{timezone}",
   "links": [
      {
         "location": "{APIBaseURL}/email/{domain}/usernames/{mailboxName}/webmail/", 
         "rel": "self"
      }
   ]
}
 

Parameters

allowUpgrade - boolean

OpenXchange allowUpgrade option value.

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

OpenXchange account type.

theme - string

Theme identifier for setting a specific theme when creating an OX account

language - string

OpenXchange account locale of type 'en_US'.

timezone - string

OpenXchange account timezone of type 'America/Chicago'.

Examples

Success getting account type

Request

GET /email/test.com/usernames/test/webmail
 

Response

200 OK

{"type": "standard", "allowUpgrade": true, "theme": "test_theme", "language": "en_US", "timezone": "America/Chicago", "links": [{"href": "{APIBaseURL}/email/test.com/usernames/test/webmail/", "rel": "self"}]}