Difference between revisions of "Exchange Mailbox (Rest API)"
From Rackspace Email & Apps API
(add Rest API Mailbox page) |
m |
||
| Line 6: | Line 6: | ||
''URL'': | ''URL'': | ||
| + | [GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Shows a list of mailboxes under the domain | |
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The show operation only supports the GET HTTP verb. For .xml format refer to the following schema document: [https://trac.iad.mlsrvr.com/trac/controlpanel3/browser/Api/trunk/lib/ControlPanel.Api/Schemas/Mailboxes.xsd Mailboxes.xsd] | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
get '/customers/12345678/domains/example.com/ex/mailboxes', 'text/xml' | get '/customers/12345678/domains/example.com/ex/mailboxes', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 42: | Line 44: | ||
=== Show === | === Show === | ||
| − | ''URL'': | + | ''URL'': |
| + | [GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name) | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | The show operation will return detailed information about the specified mailbox. | |
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The show operation only supports the GET HTTP verb. For .xml format refer to the following schema document: [https://trac.iad.mlsrvr.com/trac/controlpanel3/browser/Api/trunk/lib/ControlPanel.Api/Schemas/Mailbox.xsd Mailbox.xsd] | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml' | get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 83: | Line 87: | ||
=== Add/Edit === | === Add/Edit === | ||
| − | ''URL'': | + | ''URL'': |
| + | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name) | ||
| + | [PUT] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name) | ||
| − | |||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Adds/edits a mailbox using the specified form fields. All required fields must be supplied when adding. Other fields may be omitted. | |
| + | |||
{| border=1 class="simple" | {| border=1 class="simple" | ||
| Line 192: | Line 197: | ||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml', | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml', | ||
| Line 208: | Line 212: | ||
} | } | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 268: | Line 273: | ||
=== Delete === | === Delete === | ||
| − | ''URL'': | + | ''URL'': |
| + | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name) | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Deletes the domain. | |
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The mailbox and mailbox contents are deleted permanently. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
delete '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml' | delete '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 305: | Line 312: | ||
=== Add Email Address === | === Add Email Address === | ||
| − | ''URL'': | + | ''URL'': |
| + | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/emailaddresses/(email address) | ||
| + | |||
| − | |||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Adds a mailbox's email address. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/emailaddresses/alex@example.com', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/emailaddresses/alex@example.com', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 338: | Line 346: | ||
=== Delete Email Address === | === Delete Email Address === | ||
| − | ''URL'': | + | ''URL'': |
| + | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/emailaddresses/(email address) | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | The delete email address. | |
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The operation will fail if the email address does not exist. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
delete '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/emailaddresses/alex@example.com', 'text/xml' | delete '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/emailaddresses/alex@example.com', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 379: | Line 389: | ||
''URL'': | ''URL'': | ||
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist | [GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | + | ||
| + | This operation returns email address blacklist associated with the mailbox. | ||
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The Index operation only supports the GET HTTP verb. | |
| + | |||
''Example'': | ''Example'': | ||
| Line 391: | Line 405: | ||
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist', 'text/xml' | get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 413: | Line 428: | ||
''URL'': | ''URL'': | ||
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist | [GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | + | ||
| + | This operation returns IP blacklist associated with the mailbox. | ||
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The Index operation only supports the GET HTTP verb. | |
| + | |||
''Example'': | ''Example'': | ||
| Line 425: | Line 444: | ||
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipblacklist', 'text/xml' | get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipblacklist', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 447: | Line 467: | ||
''URL'': | ''URL'': | ||
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist | [GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | + | ||
| + | This operation returns email address safelist associated with the mailbox. | ||
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The Index operation only supports the GET HTTP verb. | |
| + | |||
''Example'': | ''Example'': | ||
| Line 459: | Line 483: | ||
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist', 'text/xml' | get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 481: | Line 506: | ||
''URL'': | ''URL'': | ||
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipsafelist | [GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipsafelist | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | + | ||
| + | This operation returns IP safelist associated with the mailbox. | ||
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The Index operation only supports the GET HTTP verb. | |
| + | |||
''Example'': | ''Example'': | ||
| Line 493: | Line 522: | ||
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipsafelist', 'text/xml' | get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipsafelist', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 515: | Line 545: | ||
''URL'': | ''URL'': | ||
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist/(email address) | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist/(email address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | |||
| − | + | Adds an email address or domain to the blacklist. | |
| − | |||
''Example'': | ''Example'': | ||
| Line 527: | Line 556: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/anyone@spam.com', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/anyone@spam.com', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 561: | Line 591: | ||
''URL'': | ''URL'': | ||
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist/(ip address) | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist/(ip address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | |||
| − | + | Adds an IP to the blacklist. | |
| − | |||
''Example'': | ''Example'': | ||
| Line 573: | Line 602: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/216.12.34.%', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/216.12.34.%', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 603: | Line 633: | ||
''URL'': | ''URL'': | ||
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(email address) | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(email address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | |||
| − | + | Adds an email address or domain to the safelist. | |
| − | |||
''Example'': | ''Example'': | ||
| Line 615: | Line 644: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/anyone@yahoo.com', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/anyone@yahoo.com', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 645: | Line 675: | ||
''URL'': | ''URL'': | ||
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(ip address) | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(ip address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | |||
| − | + | Adds an IP to the safelist. | |
| − | |||
''Example'': | ''Example'': | ||
| Line 657: | Line 686: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/216.12.34.1', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/216.12.34.1', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 687: | Line 717: | ||
''URL'': | ''URL'': | ||
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist/(email address) | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist/(email address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| + | |||
Removes an email address or domain from the blacklist. | Removes an email address or domain from the blacklist. | ||
| + | |||
''Example'': | ''Example'': | ||
| Line 695: | Line 728: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/anyone@yahoo.com', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/anyone@yahoo.com', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 729: | Line 763: | ||
''URL'': | ''URL'': | ||
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist/(ip address) | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist/(ip address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | + | ||
| + | Removes an IP from the blacklist. | ||
| + | |||
''Example'': | ''Example'': | ||
| Line 737: | Line 774: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipblacklist/216.12.34.%', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipblacklist/216.12.34.%', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 771: | Line 809: | ||
''URL'': | ''URL'': | ||
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(email address) | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(email address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| − | + | ||
| + | Removes an email address or domain from the safelist. | ||
| + | |||
''Example'': | ''Example'': | ||
| Line 779: | Line 820: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/anyone@yahoo.com', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/anyone@yahoo.com', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 813: | Line 855: | ||
''URL'': | ''URL'': | ||
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipsafelist/(email address) | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipsafelist/(email address) | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| + | |||
Removes an IP from the safelist. | Removes an IP from the safelist. | ||
| + | |||
''Example'': | ''Example'': | ||
| Line 821: | Line 866: | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipsafelist/216.12.34.1', 'text/xml' | post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipsafelist/216.12.34.1', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 855: | Line 901: | ||
''URL'': | ''URL'': | ||
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/settings | [GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/settings | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| + | |||
This operation returns the spam settings associated with the mailbox. | This operation returns the spam settings associated with the mailbox. | ||
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The Show operation only supports the GET HTTP verb. | |
| + | |||
''Example'': | ''Example'': | ||
| Line 867: | Line 917: | ||
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/settings', 'text/xml' | get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/settings', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 893: | Line 944: | ||
''URL'': | ''URL'': | ||
[PUT] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/settings | [PUT] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/settings | ||
| − | + | ||
| + | |||
''Description'': | ''Description'': | ||
| + | |||
This operation will modify the mailbox spam setting. Only 'filterlevel' is the required form field. | This operation will modify the mailbox spam setting. Only 'filterlevel' is the required form field. | ||
| + | |||
{| border=1 class="simple" | {| border=1 class="simple" | ||
| Line 922: | Line 976: | ||
Changing "filterlevel" to "off" will force "sendtodomainquarantine" to be "false". <br> | Changing "filterlevel" to "off" will force "sendtodomainquarantine" to be "false". <br> | ||
When "filterlevel" is "exclusive", spam will be sent to mailbox quarantine as default, unless "sendtodomainquarantine" is set to "true". In addition, mailbox will only receive email from addresses and IPs on its safelist. | When "filterlevel" is "exclusive", spam will be sent to mailbox quarantine as default, unless "sendtodomainquarantine" is set to "true". In addition, mailbox will only receive email from addresses and IPs on its safelist. | ||
| + | |||
''Example'': | ''Example'': | ||
| Line 930: | Line 985: | ||
} | } | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 977: | Line 1,033: | ||
''URL'': | ''URL'': | ||
| + | [GET] /customers/(customer account number)/domains/(domain name)/ex/blackberrymobileservices | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Returns a list of mailboxes that has BlackBerry mobile service enabled. | |
| − | + | ||
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The index operation only supports the GET HTTP verb. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
get '/customers/12345678/domains/example.com/ex/blackberrymobileservices', 'text/xml' | get '/customers/12345678/domains/example.com/ex/blackberrymobileservices', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 1,015: | Line 1,073: | ||
''URL'': | ''URL'': | ||
| + | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/blackberrymobileservice | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Attaches a BlackBerry mobile service to the mailbox. | |
| + | |||
{| border=1 class="simple" | {| border=1 class="simple" | ||
| Line 1,034: | Line 1,093: | ||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml', | post '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml', | ||
| Line 1,041: | Line 1,099: | ||
} | } | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 1,070: | Line 1,129: | ||
''URL'': | ''URL'': | ||
| + | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/blackberrymobileservice | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Detaches a BlackBerry mobile service from a mailbox. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
delete '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml' | delete '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 1,105: | Line 1,165: | ||
''URL'': | ''URL'': | ||
| + | [GET] /customers/(customer account number)/domains/(domain name)/ex/activesyncmobileservices | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Returns a list of mailboxes that has ActiveSync mobile service enabled. | |
| − | + | ||
| + | |||
''Remarks'': | ''Remarks'': | ||
| − | + | The index operation only supports the GET HTTP verb. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
get '/customers/12345678/domains/example.com/ex/activesyncmobileservices', 'text/xml' | get '/customers/12345678/domains/example.com/ex/activesyncmobileservices', 'text/xml' | ||
| Line 1,143: | Line 1,204: | ||
''URL'': | ''URL'': | ||
| + | [POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/activesyncmobileservice | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Attaches a ActiveSync service to the mailbox. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
post '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml', | post '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml', | ||
| Line 1,158: | Line 1,219: | ||
} | } | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
| Line 1,187: | Line 1,249: | ||
''URL'': | ''URL'': | ||
| + | [DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/blackberrymobileservice | ||
| − | |||
''Description'': | ''Description'': | ||
| − | + | Detaches a ActiveSync mobile service from a mailbox. | |
| + | |||
''Example'': | ''Example'': | ||
| − | |||
<pre> | <pre> | ||
delete '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml' | delete '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml' | ||
</pre> | </pre> | ||
| + | |||
''Errors'': | ''Errors'': | ||
Revision as of 13:06, 25 August 2009
Contents
- 1 Mailbox
- 1.1 Index
- 1.2 Show
- 1.3 Add/Edit
- 1.4 Delete
- 1.5 Add Email Address
- 1.6 Delete Email Address
- 1.7 Spam
- 1.7.1 Index Blacklist
- 1.7.2 Index IP Blacklist
- 1.7.3 Index Safelist
- 1.7.4 Index IP Safelist
- 1.7.5 Add Blacklist
- 1.7.6 Add IP Blacklist
- 1.7.7 Add Safelist
- 1.7.8 Add IP Safelist
- 1.7.9 Delete Blacklist
- 1.7.10 Delete IP Blacklist
- 1.7.11 Delete Safelist
- 1.7.12 Delete IP Safelist
- 1.7.13 Show Spam Setting
- 1.7.14 Edit Spam Setting
- 1.8 BlackBerry Mobile Service
- 1.9 ActiveSync Mobile Service
Mailbox
Index
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes
Description:
Shows a list of mailboxes under the domain
Remarks:
The show operation only supports the GET HTTP verb. For .xml format refer to the following schema document: Mailboxes.xsd
Example:
get '/customers/12345678/domains/example.com/ex/mailboxes', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
Show
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)
Description:
The show operation will return detailed information about the specified mailbox.
Remarks:
The show operation only supports the GET HTTP verb. For .xml format refer to the following schema document: Mailbox.xsd
Example:
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
Add/Edit
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name) [PUT] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)
Description:
Adds/edits a mailbox using the specified form fields. All required fields must be supplied when adding. Other fields may be omitted.
| Field Name | Data Type | Description |
|---|---|---|
| displayName | string | Display name (Required for Add) |
| initialPassword | string | Password (Required for Add) |
| size | positive integer | Mailbox size in megabytes (Required for Add) |
| isHidden | boolean | Indicates whether or not the mailbox is hidden from the Global Address List |
| isPublicFolderAdmin | boolean | Indicates whether or not the account is a public folder administrator |
| firstName | string | First name |
| lastName | string | Last name |
| company | string | Company |
| department | string | Department |
| jobTitle | string | Job title |
| addressLine1 | string | Street address |
| city | string | City |
| state | string | State |
| zip | string | Zip or postal code |
| country | string | Country |
| businessnumber | string | Business phone number |
| pagernumber | string | Pager phone number |
| homenumber | string | Home phone number |
| mobilenumber | string | Mobile phone number |
| faxnumber | string | Fax phone number |
| notes | string | Notes field |
| emailForwardingAddress | string | Forwarding email address (If this field is assigned an email address, then email forwarding will be turned on. If this field is not assigned or assigned an empty string, then email forwarding will be disabled.) |
| enabled | string | Enable/Disable mailbox, input must be "true" or "false" |
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml',
{
'displayName' => 'Alex Smith',
'initialPassword' => 'Secret123!@#',
'size' => '2048'
}
put '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml',
{
'homenumber' => '8005551234'
}
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
| Required form field is missing | 400 | Missing required field: displayName |
| Required form field has null or empty string input | 400 | Required field displayName cannot be empty |
| New mailbox name (user name) doesn't meet the naming requirements | 400 | Invalid user name |
| New mailbox display name doesn't meet the naming requirements | 400 | Invalid display name |
| Integer form field has non-integer input | 400 | Invalid format for size, input must be an integer |
| Boolean form field has non-boolean input | 400 | Invalid format for Enabled, input must be True or False |
| New mailbox password doesn't meet the password pattern requirements | 400 | Password must be at least 8 characters long |
| Form data has unrecognized field | 400 | Unrecognized field: extraStorage |
| New mailbox name (user name) already exists | 400 | The email address john.doe@abc.com is already in use |
Delete
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)
Description:
Deletes the domain.
Remarks:
The mailbox and mailbox contents are deleted permanently.
Example:
delete '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
Add Email Address
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/emailaddresses/(email address)
Description:
Adds a mailbox's email address.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/emailaddresses/alex@example.com', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
Delete Email Address
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/emailaddresses/(email address)
Description:
The delete email address.
Remarks:
The operation will fail if the email address does not exist.
Example:
delete '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/emailaddresses/alex@example.com', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
Spam
Index Blacklist
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist
Description:
This operation returns email address blacklist associated with the mailbox.
Remarks:
The Index operation only supports the GET HTTP verb.
Example:
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
Index IP Blacklist
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist
Description:
This operation returns IP blacklist associated with the mailbox.
Remarks:
The Index operation only supports the GET HTTP verb.
Example:
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipblacklist', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
Index Safelist
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist
Description:
This operation returns email address safelist associated with the mailbox.
Remarks:
The Index operation only supports the GET HTTP verb.
Example:
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
Index IP Safelist
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipsafelist
Description:
This operation returns IP safelist associated with the mailbox.
Remarks:
The Index operation only supports the GET HTTP verb.
Example:
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipsafelist', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
Add Blacklist
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist/(email address)
Description:
Adds an email address or domain to the blacklist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/anyone@spam.com', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid email or domain | 400 | invalid email address: abc |
| Entered current domain | 400 | Adding example.com would blacklist the current domain |
Add IP Blacklist
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist/(ip address)
Description:
Adds an IP to the blacklist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/216.12.34.%', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid IP address | 400 | invalid ip address: 123 |
Add Safelist
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(email address)
Description:
Adds an email address or domain to the safelist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/anyone@yahoo.com', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid email or domain | 400 | invalid email address: abc |
Add IP Safelist
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(ip address)
Description:
Adds an IP to the safelist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/216.12.34.1', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid IP address | 400 | invalid ip address: 123 |
Delete Blacklist
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/blacklist/(email address)
Description:
Removes an email address or domain from the blacklist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/blacklist/anyone@yahoo.com', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid email or domain | 400 | invalid email address: abc |
| Entered email or domain is not on the current blacklist | 400 | abc@junkmail.com is not found on the blacklist |
Delete IP Blacklist
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipblacklist/(ip address)
Description:
Removes an IP from the blacklist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipblacklist/216.12.34.%', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid IP address | 400 | invalid ip address: 123 |
| Entered IP is not on the current blacklist | 400 | 216.12.34.1 is not found on the blacklist |
Delete Safelist
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/safelist/(email address)
Description:
Removes an email address or domain from the safelist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/safelist/anyone@yahoo.com', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid email or domain | 400 | invalid email address: abc |
| Entered email or domain is not on the current safelist | 400 | anyone@yahoo.com is not found on the safelist |
Delete IP Safelist
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/ipsafelist/(email address)
Description:
Removes an IP from the safelist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/ipsafelist/216.12.34.1', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Entered invalid IP address | 400 | invalid ip address: 123 |
| Entered IP is not on the current safelist | 400 | 216.12.34.1 is not found on the safelist |
Show Spam Setting
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/settings
Description:
This operation returns the spam settings associated with the mailbox.
Remarks:
The Show operation only supports the GET HTTP verb.
Example:
get '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/settings', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
Edit Spam Setting
URL:
[PUT] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/spam/settings
Description:
This operation will modify the mailbox spam setting. Only 'filterlevel' is the required form field.
| Field Name | Data Type | Description |
|---|---|---|
| filterlevel | string | Spam filter status, must be 'on'/'off'/'exclusive' (Required) |
| sendtodomainquarantine | boolean | Indicates whether or not send spam to domain quarantine |
| quarantineowner | string | The email address that quarantine notifications be sent to |
Remarks:
Form field "filterlevel" is always required.
When "filterlevel" is "on", spam will be sent to mailbox quarantine as default, unless "sendtodomainquarantine" is set to "true".
Changing "filterlevel" to "off" will force "sendtodomainquarantine" to be "false".
When "filterlevel" is "exclusive", spam will be sent to mailbox quarantine as default, unless "sendtodomainquarantine" is set to "true". In addition, mailbox will only receive email from addresses and IPs on its safelist.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/alex.smith/spam/settings', 'text/xml',
{
'filterlevel' => 'off'
}
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | No user with the email address alex.smith@example.com exists |
| Required form field is missing | 400 | Missing required field: filterlevel |
| Required form field has null or empty string input | 400 | Required field filterlevel cannot be empty |
| Form data has unrecognized field | 400 | Unrecognized field: address |
| Boolean form field has non-boolean input | 400 | Invalid format for sendtodomainquarantine, input must be true or false |
| Invalid input for form field 'filterlevel' | 400 | Invalid filterLevel, input must be: on/off/exclusive |
BlackBerry Mobile Service
Index
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/blackberrymobileservices
Description:
Returns a list of mailboxes that has BlackBerry mobile service enabled.
Remarks:
The index operation only supports the GET HTTP verb.
Example:
get '/customers/12345678/domains/example.com/ex/blackberrymobileservices', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
Add
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/blackberrymobileservice
Description:
Attaches a BlackBerry mobile service to the mailbox.
| Field Name | Data Type | Description |
|---|---|---|
| activationPassword | string | Activation password () (Required) |
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml',
{
'activationPassword' => '12345'
}
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
| Mailbox already has BlackBerry Service | 400 | User john.smith@example.com has BlackBerry Mobile Service already |
Delete
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/blackberrymobileservice
Description:
Detaches a BlackBerry mobile service from a mailbox.
Example:
delete '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
ActiveSync Mobile Service
Index
URL:
[GET] /customers/(customer account number)/domains/(domain name)/ex/activesyncmobileservices
Description:
Returns a list of mailboxes that has ActiveSync mobile service enabled.
Remarks:
The index operation only supports the GET HTTP verb.
Example:
get '/customers/12345678/domains/example.com/ex/activesyncmobileservices', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
Add
URL:
[POST] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/activesyncmobileservice
Description:
Attaches a ActiveSync service to the mailbox.
Example:
post '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml',
{
'activationPassword' => '12345'
}
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 404 | Invalid format |
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
| Mailbox already has BlackBerry Service | 400 | User john.smith@example.com has BlackBerry Mobile Service already |
Delete
URL:
[DELETE] /customers/(customer account number)/domains/(domain name)/ex/mailboxes/(mailbox name)/blackberrymobileservice
Description:
Detaches a ActiveSync mobile service from a mailbox.
Example:
delete '/customers/12345678/domains/example.com/ex/mailboxes/john.smith/blackberrymobileservice', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Domain is not found | 404 | abc.com not found |
| Mailbox is not found | 404 | Mailbox not found |
