Skip to content

GetNewDocumentsAndFoldersLog API

Returns the log of newly created documents and folders matching the specified date range and path filter.

Endpoint

/srv.asmx/GetNewDocumentsAndFoldersLog

Methods

  • GET /srv.asmx/GetNewDocumentsAndFoldersLog?authenticationTicket=...&startDate=...&endDate=...&pathFilter=...
  • POST /srv.asmx/GetNewDocumentsAndFoldersLog (form data)
  • SOAP Action: http://tempuri.org/GetNewDocumentsAndFoldersLog

Parameters

All filter parameters are optional. When all filters are omitted, all creation log entries in the system are returned (requires system-wide permission — see Required Permissions).

Parameter Type Required Description
authenticationTicket string Yes Authentication ticket obtained from AuthenticateUser.
startDate DateTime No Return entries with an action date on or after this value. Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss. UTC values are converted to server local time. Leave empty for no lower bound.
endDate DateTime No Return entries with an action date on or before this value. UTC values are converted to server local time. Leave empty for no upper bound.
pathFilter string No Path filter scoping the query. Also controls the required permission level — see Required Permissions. Supports wildcard * at the end (e.g. \MyLibrary\Reports*). Leave empty to query all libraries.

Required Permissions

The required permission level depends on the pathFilter value:

pathFilter value Required permission
Empty or omitted System-wide ViewAuditLogs admin permission
Unresolvable path (library name not found) System-wide ViewAuditLogs admin permission
Starts with a valid library name (e.g. \MyLibrary or \MyLibrary\Reports*) ViewAuditLogs permission for that library only

When a library name is resolved from the path, the query is automatically scoped to that library. Library-level audit log administrators can therefore query their own library without system-wide admin rights.

Response

Success Response

Returns a <response> element with success="true" containing a <logs> element with zero or more <log> child elements. Results are ordered by action date descending (most recent first).

<response success="true">
  <logs>
    <log TYPE="DOCUMENT" ID="1234" NAME="Report.docx" DATE="2026-02-01 14:30:00"
         DOMAINID="1" DOMAINNAME="MyLibrary" PATH="\MyLibrary\Reports"
         USERID="5" FULLNAME="John Smith" />
    <log TYPE="FOLDER" ID="567" NAME="Archive" DATE="2026-01-28 09:15:00"
         DOMAINID="1" DOMAINNAME="MyLibrary" PATH="\MyLibrary"
         USERID="5" FULLNAME="John Smith" />
  </logs>
</response>

Log Entry Attribute Reference

Attribute Type Description
TYPE string Object type: DOCUMENT or FOLDER.
ID int Internal ID of the created object.
NAME string Name of the created document or folder.
DATE string Date and time of creation (server local time, yyyy-MM-dd HH:mm:ss).
DOMAINID int Internal ID of the library the object was created in.
DOMAINNAME string Name of the library (first path segment).
PATH string Full parent path of the created object.
USERID int Internal user ID of the person who created the object.
FULLNAME string Full name of the person who created the object.

Empty Result

<response success="true">
  <logs />
</response>

Error Response

<response success="false" error="[ErrorCode] Error message" />

Example Requests

GET — system-wide query

GET /srv.asmx/GetNewDocumentsAndFoldersLog?authenticationTicket=abc123-def456&startDate=2026-01-01&endDate=2026-02-01 HTTP/1.1
Host: server.example.com

GET — scoped to a library

GET /srv.asmx/GetNewDocumentsAndFoldersLog?authenticationTicket=abc123-def456&startDate=2026-01-01&endDate=2026-02-01&pathFilter=\MyLibrary* HTTP/1.1
Host: server.example.com

POST

POST /srv.asmx/GetNewDocumentsAndFoldersLog HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=abc123-def456&startDate=2026-01-01&endDate=2026-02-01&pathFilter=\MyLibrary*

SOAP 1.1

POST /srv.asmx HTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://tempuri.org/GetNewDocumentsAndFoldersLog"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetNewDocumentsAndFoldersLog xmlns="http://tempuri.org/">
      <authenticationTicket>abc123-def456</authenticationTicket>
      <startDate>2026-01-01</startDate>
      <endDate>2026-02-01</endDate>
      <pathFilter>\MyLibrary*</pathFilter>
    </GetNewDocumentsAndFoldersLog>
  </soap:Body>
</soap:Envelope>

Notes

  • pathFilter also sets permission scope: providing a valid library name in the path is not just a filter — it also reduces the required permission to library-level ViewAuditLogs. Omitting the path queries all libraries and requires system-wide admin rights.
  • pathFilter wildcards: use * as a trailing wildcard. \MyLibrary\Reports* matches all objects created under that folder. An exact path is used when no * is present.
  • Library-only path: when pathFilter is exactly a library name (e.g. \MyLibrary), the path filter is cleared internally and all creation records within that library are returned.
  • UTC input: startDate and endDate may be submitted as UTC values; the server converts them to local time before filtering.
  • DATE format: the DATE attribute in the response is server local time, not UTC.
  • Creation logging must be enabled in the domain policies for entries to be recorded.

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.
Insufficient rights. The caller does not have the required ViewAuditLogs permission.
SystemError:... An unexpected server-side error occurred.