apidocs

GetDownloadQue API

Returns the list of documents and folders that the current authenticated user has added to their download queue. The download queue is a personal per-user collection of items staged for bulk download. The response uses the same full-detail folder and document element format as GetFoldersAndDocuments. Optional flags control whether additional detail (folder rules, property sets, security, owner, version history) is included for each item.

Endpoint


/srv.asmx/GetDownloadQue

Methods

GET /srv.asmx/GetDownloadQue?AuthenticationTicket=...&withrules=...&withpropertysets=...&withsecurity=...&withOwner=...&withVersions=...
POST /srv.asmx/GetDownloadQue (form data)
SOAP Action: http://tempuri.org/GetDownloadQue

Parameters

Parameter	Type	Required	Description
`AuthenticationTicket`	string	Yes	Authentication ticket obtained from `AuthenticateUser`.
`withrules`	bool	Yes	`true` to include folder rules (`<Rules>` child element) for each folder in the queue. `false` to omit. Has no effect on document items.
`withpropertysets`	bool	Yes	`true` to include applied custom property set data (`<PropertySets>` child element) for each item. `false` to omit.
`withsecurity`	bool	Yes	`true` to include the access control list (`<AccessList>` child element) for each item. `false` to omit.
`withOwner`	bool	Yes	`true` to include owner user information as a child element for each item. `false` to omit.
`withVersions`	bool	Yes	`true` to include document version history (`<Versions>` child element) for each document. `false` to omit. Has no effect on folder items.

Performance tip: Set all boolean flags to false for the fastest, most compact response. Only enable the flags your application actually needs.

Response

Success Response

Returns a <root> element with <folder> and <document> child elements -“ folders first, then documents sorted by name ascending. If the download queue is empty, the root element is returned with no children.

<root success="true">

  <!-- Folder items in the download queue -->

  <folder FolderID="42"

          ParentID="10"

          Name="Q1 Reports"

          Path="/Finance/Reports/Q1 Reports"

          Description="First quarter reports"

          CreationDate="2024-01-15"

          OwnerName="jsmith"

          DomainId="3"

          ClassificationLevel="NoMarkings"

          ClassificationLevelId="0"

          DeclassifyOn=""

          DowngradeOn=""

          RDDefId="0"

          RetentionDate=""

          DispositionDate=""

          CutoffDate="">

    <!-- Included only when withrules=true -->

    <Rules>

      <Rule Name="AllowableFileTypes"  Value="*" />

      <Rule Name="Checkins"            Value="allows" />

      <Rule Name="Checkouts"           Value="allows" />

      <Rule Name="DocumentDeletes"     Value="allows" />

      <Rule Name="FolderDeletes"       Value="allows" />

      <Rule Name="NewDocuments"        Value="allows" />

      <Rule Name="NewFolders"          Value="allows" />

      <Rule Name="ClassifiedDocuments" Value="disallows" />

    </Rules>

    <!-- Included only when withpropertysets=true -->

    <PropertySets> ... </PropertySets>

    <!-- Included only when withsecurity=true -->

    <AccessList DateApplied="2024-01-15" AppliedBy="admin" InheritedSecurity="false"> ... </AccessList>

    <!-- Included only when withOwner=true -->

    <User UserID="7" UserName="jsmith" FullName="John Smith" ... />

  </folder>

  <!-- Document items in the download queue -->

  <document DocumentID="1051"

            Name="Q1-2024-Report.pdf"

            Path="\Finance\Reports"

            Description="Q1 financial summary"

            CreationDate="2024-03-01"

            ModificationDate="2024-06-15"

            Size="204800"

            Type="PDF Document"

            VersionNumber="3"

            PublishedVersionNumber="3"

            OwnerName="jsmith"

            ...>

    <!-- Included only when withpropertysets=true -->

    <PropertySets> ... </PropertySets>

    <!-- Included only when withsecurity=true -->

    <AccessList DateApplied="2024-03-01" AppliedBy="jsmith" InheritedSecurity="true"> ... </AccessList>

    <!-- Included only when withOwner=true -->

    <User UserID="7" UserName="jsmith" FullName="John Smith" ... />

    <!-- Included only when withVersions=true -->

    <Versions> ... </Versions>

  </document>

</root>

Folder Element Attributes

See GetFoldersAndDocuments for the full list of folder attributes and their descriptions. The folder element structure is identical.

Document Element Attributes

See GetFoldersAndDocuments for the full list of document attributes and their descriptions. The document element structure is identical, including the UserViewStatus attribute (0 = never viewed, 1 = viewed but changed, 2 = viewed current version).

Optional Child Elements

Element	Enabled by	Applies to
`<Rules>`	`withrules=true`	Folders only
`<PropertySets>`	`withpropertysets=true`	Folders and documents
`<AccessList>`	`withsecurity=true`	Folders and documents
`<User>`	`withOwner=true`	Folders and documents
`<Versions>`	`withVersions=true`	Documents only

Error Response

<root success="false" error="[901] Session expired or Invalid ticket" />

Required Permissions

Any authenticated user may call this API. The response always reflects the download queue of the currently authenticated user -“ callers cannot query another user’s download queue. Items in the queue that the user no longer has access to may be excluded from the response.

Example

GET Request -“ minimal (no extra detail)

GET /srv.asmx/GetDownloadQue

  ?AuthenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301

  &withrules=false

  &withpropertysets=false

  &withsecurity=false

  &withOwner=false

  &withVersions=false

HTTP/1.1

GET Request -“ with full detail

GET /srv.asmx/GetDownloadQue

  ?AuthenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301

  &withrules=true

  &withpropertysets=true

  &withsecurity=true

  &withOwner=true

  &withVersions=true

HTTP/1.1

POST Request

POST /srv.asmx/GetDownloadQue HTTP/1.1

Content-Type: application/x-www-form-urlencoded

AuthenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301

&withrules=false

&withpropertysets=false

&withsecurity=false

&withOwner=false

&withVersions=false

SOAP Request

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

               xmlns:tns="http://tempuri.org/">

  <soap:Body>

    <tns:GetDownloadQue>

      <tns:AuthenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:AuthenticationTicket>

      <tns:withrules>false</tns:withrules>

      <tns:withpropertysets>false</tns:withpropertysets>

      <tns:withsecurity>false</tns:withsecurity>

      <tns:withOwner>false</tns:withOwner>

      <tns:withVersions>false</tns:withVersions>

    </tns:GetDownloadQue>

  </soap:Body>

</soap:Envelope>

Notes

The download queue belongs to the currently authenticated user only. There is no parameter to specify a different user.
Folders appear before documents in the response. Documents within the queue are sorted alphabetically by name in ascending order.
If the download queue is empty, the response is <root success="true" /> with no child elements.
withrules applies only to folder items -“ it has no effect on document elements.
withVersions applies only to document items -“ it has no effect on folder elements.
Items are returned with their current properties at the time of the call. Items added to the queue from documents or folders that have since been deleted or moved may no longer appear in the response.
Setting all boolean flags to false returns only the core attributes for each item, which is the fastest and most compact response.

GetFavorites - Returns the current user’s favorites list (documents and folders)
GetRecentDocuments - Returns recently accessed documents for the current user
GetFoldersAndDocuments - Returns folders and documents within a specific folder path
DownloadZip - Download multiple documents and folders as a zip archive
DownloadZipWithHandler - Stage a zip archive of multiple items for chunked download

Error Codes

Error	Description
`[900] Authentication failed`	Invalid or missing authentication ticket.
`[901] Session expired or Invalid ticket`	The ticket has expired or does not exist.
User has been deleted	The authenticated user account no longer exists.
`SystemError:...`	An unexpected server-side error occurred.