Sign in

v1

latestOpenAPI 3.0.02026-07-135965404.0 KB
Activity

Get activity logs

Returns the detailed activity logs for your account. Optional query paramaters will filter the returned results based on a number of options including usernames, activity types, or date ranges.

NOTE: Total Results will always return as 0 to avoid quering data you're not using and stay as performant as possible.

Operation Types Session activity is logged with an operation type that is different from what is visible through the activity log interface in the web file manager. Consult the table below to compare the two:

File Manager ValueAPI ValueNotes
ConnectPASS
DisconnectEXIT
UploadSTOR
DownloadRETR
DeleteDELE
Create FolderMKD
RenameRNTO
MoveMOVE
CopyCOPY
CompressCOMPR
ExtractEXTRACT
Shared FoldersSHARE
Send FilesSEND
Receive FilesRECV
N/AEDIT_SENDUpdate send. Not shown in file manager
Update ShareEDIT_SHARE
Update ReceiveEDIT_RECV
Delete SendDELE_SEND
Delete ReceiveDELE_RECV
Delete ShareDELE_SHARE
Create NotificationNOTIFY
Update NotificationEDIT_NTFY
Delete NotificationDELE_NTFY
Create UserUSER
Update UserEDIT_USER
Delete UserDELE_USER
N/ADFACreate direct link. Not shown in file manager
N/AEDIT_DFAUpdate direct link options. Not shown in file manager
N/ADELE_DFADeactivate direct link. Not shown in file manager
get/activity/session

Query parameters

startDatestring date-time

Start date of the filter data range

endDatestring date-time

End date of the filter data range

ipAddressstring

Used to filter session logs by ip address.

usernamestring

Username used for filtering a list

pathstring

Path used to filter records

typestring

Filter session logs for operation type (see table above for acceptable values)

offsetinteger

Offset of the records list

limitinteger

Limit of the records list

sortstring
Example:-date

Comma separated list sort params

Headers

ev-api-keystring required
Example:exampleaccount-zwSuWUZ8S38h33qPS8v0s

API Key

ev-access-tokenstring required
Example:19853ef63a0bc348024a9e4cfd4a92520d2dfd04e88d8679fb1ed6bc551593d1

Access Token

Response

Successful operation

responseStatusinteger
totalResultsinteger
returnedResultsinteger

Example response

{
  "responseStatus": 200,
  "totalResults": 2,
  "returnedResults": 2,
  "data": [
    {
      "id": 12345,
      "type": "sessionActivity",
      "attributes": {
        "bytesTransferred": 10815676,
        "created": "2019-10-18T06:48:40Z",
        "duration": 5,
        "fileName": "/test2/Cassandra2020The20Definitive20Guide.2030947496.pdf",
        "ipAddress": "185.223.113.224",
        "operation": "PASS",
        "protocol": "web",
        "sessionId": "5da9b4a8bd961dfa0a56fa0dc15aaffe57069271b389e",
        "status": "-",
        "username": "ykravchuk"
      }
    }
  ]
}