Zimbra REST API Reference:Get Folder

From Zimbra :: Wiki

Jump to: navigation, search
Introduction  


Method: Get Folder  


Method: Import Message  


Method: Get Contacts  


Method: Import Contacts  


Method: Get Calendar  


Method: Get FreeBusy  


Method: Import Appointments  


Method: Get Tasks  


Method: Get Item  


Method: Get Briefcase  


Method: Get Briefcase Item  


Method: Export Mailbox  


 


Developer Article

Article Information

This article applies to the following ZCS versions.
  ZCS 8.0 Article  ZCS 8.0
  ZCS 7.0 Article  ZCS 7.0
  ZCS 6.0 Article  ZCS 6.0

<< Back to Zimbra REST API Reference

Contents

REST API Method: Get Folder

Gets the items in the folder.

URL

http://localhost:7070/home/john.doe/{folder-name}?{params}

Go to Command Format

HTTP Method

GET

Folder Name

{folder-name}. The name of the mail folder to access. This can be a default or a user-defined folder. Default folders include:

  • inbox. The inbox folder.
  • drafts. The drafts folder.
  • sent. The sent items folder.
  • trash. The trash folder.
  • junk. The junk/spam folder.

Formats

xml,json,rss,zip,tar,tgz (Go to Response Formats)

Note: When using the zip,tar,tgz formats, the mail messages are packaged in the archive as .eml files (i.e. plain text in MIME format).

Requires Authentication

true (Go to Authentication)

Parameters

  • fmt. Required. The response format.
  • query. Optional. A query string.

Usage Examples

Retrieve the inbox folder in RSS format:

http://localhost:7070/home/john.doe/inbox?fmt=rss

Retrieve the inbox folder in XML format:

http://localhost:7070/home/john.doe/inbox?fmt=xml

Retrieve the drafts folder, query for keyword "automobile", in XML format:

http://localhost:7070/home/john.doe/drafts?fmt=xml&query=automobile

Retrieve the inbox folder, query for "automobile" in the message subject, in XML format:

http://localhost:7070/home/john.doe/inbox?fmt=xml&query=subject:automobile

Retrieve the inbox folder, query for "unread" messages, in XML format:

http://localhost:7070/home/john.doe/inbox?fmt=xml&query=is:unread

Retrieve the inbox folder, query for tag "test", in XML format:

http://localhost:7070/home/john.doe/inbox?fmt=xml&query=tag:test

Retrieve the inbox folder, query for phrase "new automobile" in the message subject, in XML format:

http://localhost:7070/home/john.doe/inbox?fmt=xml&query=subject:"new+automobile"

Retrieve the user-defined folder "mycustomers", in JSON format:

http://localhost:7070/home/john.doe/mycustomers?fmt=json


Verified Against: Zimbra Collaboration Server 7.0 Date Created: 01/16/2010
Article ID: http://wiki.zimbra.com/index.php?title=Zimbra_REST_API_Reference:Get_Folder Date Modified: 08/5/2014
Personal tools