action exavault_get_session_logs {
  label: "Get activity logs"
  description: "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. \n\n**NOTE:** Total Results will always return as 0 to avoid quering data you're not using and stay as performant as possible. \n  \n**Operation Types**\nSession activity is logged with an operation type that is different from what is visible through the [activity log interface in the web file manager](/docs/account/10-activity-logs/00-activity-logs). Consult the table below to compare the two:\n\n| File Manager Value | API Value | Notes |\n|-----|----|---|\n| Connect | PASS | |\n| Disconnect | EXIT | |\n| Upload | STOR | |\n| Download | RETR | |\n| Delete | DELE | |\n| Create Folder | MKD | |\n| Rename | RNTO | |\n| Move | MOVE | |\n| Copy | COPY | |\n| Compress | COMPR | |\n| Extract | EXTRACT | |\n| Shared Folders | SHARE | |\n| Send Files | SEND | |\n| Receive Files | RECV | |\n| _N/A_ | EDIT\\_SEND | Update send. Not shown in file manager |\n| Update Share | EDIT\\_SHARE| | \n| Update Receive | EDIT\\_RECV | |\n| Delete Send | DELE\\_SEND | |\n| Delete Receive | DELE\\_RECV | |\n| Delete Share | DELE\\_SHARE | |\n| Create Notification | NOTIFY | |\n| Update Notification | EDIT\\_NTFY| |\n| Delete Notification | DELE\\_NTFY | |\n| Create User | USER | |\n| Update User | EDIT\\_USER | |\n| Delete User | DELE\\_USER | |\n| _N/A_ | DFA | Create direct link. Not shown in file manager |\n| _N/A_ | EDIT\\_DFA | Update direct link options. Not shown in file manager |\n| _N/A_ | DELE\\_DFA | Deactivate direct link. Not shown in file manager|\n"
  provider: exavault
  method: GET
  path: "/activity/session"
  encoding: json
  input: {
    type: "object"
    properties: {
      endDate: {
        type: "string"
        format: "date-time"
      }
      "ev-access-token": {
        type: "string"
      }
      "ev-api-key": {
        type: "string"
      }
      ipAddress: {
        type: "string"
      }
      limit: {
        type: "integer"
      }
      offset: {
        type: "integer"
      }
      path: {
        type: "string"
      }
      sort: {
        type: "string"
      }
      startDate: {
        type: "string"
        format: "date-time"
      }
      type: {
        type: "string"
      }
      username: {
        type: "string"
      }
    }
    required: ["ev-access-token", "ev-api-key"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Session activity list response"
    properties: {
      data: {
        type: "array"
        items: {
          type: "object"
          description: "Single entry of session activity"
          properties: {
            attributes: {
              type: "object"
              properties: {
                bytesTransferred: {
                  type: "integer"
                  format: "int64"
                }
                created: {
                  type: "string"
                }
                duration: {
                  type: "integer"
                }
                fileName: {
                  type: "string"
                }
                fileSource: {
                  type: "string"
                }
                ipAddress: {
                  type: "string"
                }
                operation: {
                  type: "string"
                }
                protocol: {
                  type: "string"
                }
                sessionId: {
                  type: "string"
                }
                status: {
                  type: "string"
                }
                username: {
                  type: "string"
                }
              }
            }
            id: {
              type: "integer"
              format: "int64"
            }
            type: {
              type: "string"
              enum: ["sessionActivity"]
            }
          }
        }
      }
      responseStatus: {
        type: "integer"
      }
      returnedResults: {
        type: "integer"
      }
      totalResults: {
        type: "integer"
      }
    }
  }
}