v4

latestSwagger 2.02026-08-0343714211.7 MB

public_hosting_request_logs

Public Hosting Request Logs

List Public Hosting Request Logs

get/public_hosting_request_logs

Query parameters

cursorstring

Used for pagination. When a list request has more records available, cursors are provided in the response headers X-Files-Cursor-Next and X-Files-Cursor-Prev. Send one of those cursor value here to resume an existing list from the next available record. Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.

per_pageinteger

Number of records to show per page. (Max: 1000, 1,000 or less is recommended).

If set, return records where the specified field is equal to the supplied value. Valid fields are path, remote_ip, success or created_at. Valid field combinations are [ path ], [ remote_ip ], [ success ], [ created_at ], [ path, remote_ip ], [ path, success ], [ path, created_at ], [ remote_ip, success ], [ remote_ip, created_at ], [ success, created_at ], [ path, remote_ip, success ], [ path, remote_ip, created_at ], [ path, success, created_at ], [ remote_ip, success, created_at ] or [ path, remote_ip, success, created_at ].

If set, return records where the specified field is greater than the supplied value. Valid fields are created_at. Valid field combinations are [ path ], [ remote_ip ], [ success ], [ created_at ], [ path, remote_ip ], [ path, success ], [ path, created_at ], [ remote_ip, success ], [ remote_ip, created_at ], [ success, created_at ], [ path, remote_ip, success ], [ path, remote_ip, created_at ], [ path, success, created_at ], [ remote_ip, success, created_at ] or [ path, remote_ip, success, created_at ].

If set, return records where the specified field is greater than or equal the supplied value. Valid fields are created_at. Valid field combinations are [ path ], [ remote_ip ], [ success ], [ created_at ], [ path, remote_ip ], [ path, success ], [ path, created_at ], [ remote_ip, success ], [ remote_ip, created_at ], [ success, created_at ], [ path, remote_ip, success ], [ path, remote_ip, created_at ], [ path, success, created_at ], [ remote_ip, success, created_at ] or [ path, remote_ip, success, created_at ].

If set, return records where the specified field is prefixed by the supplied value. Valid fields are path. Valid field combinations are [ path ], [ remote_ip ], [ success ], [ created_at ], [ path, remote_ip ], [ path, success ], [ path, created_at ], [ remote_ip, success ], [ remote_ip, created_at ], [ success, created_at ], [ path, remote_ip, success ], [ path, remote_ip, created_at ], [ path, success, created_at ], [ remote_ip, success, created_at ] or [ path, remote_ip, success, created_at ].

If set, return records where the specified field is less than the supplied value. Valid fields are created_at. Valid field combinations are [ path ], [ remote_ip ], [ success ], [ created_at ], [ path, remote_ip ], [ path, success ], [ path, created_at ], [ remote_ip, success ], [ remote_ip, created_at ], [ success, created_at ], [ path, remote_ip, success ], [ path, remote_ip, created_at ], [ path, success, created_at ], [ remote_ip, success, created_at ] or [ path, remote_ip, success, created_at ].

If set, return records where the specified field is less than or equal the supplied value. Valid fields are created_at. Valid field combinations are [ path ], [ remote_ip ], [ success ], [ created_at ], [ path, remote_ip ], [ path, success ], [ path, created_at ], [ remote_ip, success ], [ remote_ip, created_at ], [ success, created_at ], [ path, remote_ip, success ], [ path, remote_ip, created_at ], [ path, success, created_at ], [ remote_ip, success, created_at ] or [ path, remote_ip, success, created_at ].

Response

A list of PublicHostingRequestLogs objects.

timestampstring date-time

Start Time of Action. Deprecrated: Use created_at.

remote_ipstring

IP Address of Public Hosting Client.

server_ipstring

IP Address of Public Hosting Server.

hostnamestring

HTTP Request Hostname.

pathstring

HTTP Request Path.

responseCodeinteger

HTTP Response Code.

successboolean

Whether SFTP Action was successful.

duration_msinteger

Duration (in milliseconds).

created_atstring date-time

Start Time of Action.

bytes_transferredinteger

The number of bytes transferred for file downloads.

http_methodstring

Method of the HTTP call.

Example response

[
  {
    "timestamp": "2000-01-01T01:00:00Z",
    "remote_ip": "example",
    "server_ip": "example",
    "hostname": "example",
    "path": "example",
    "responseCode": 1,
    "success": true,
    "duration_ms": 1,
    "created_at": "2000-01-01T01:00:00Z",
    "bytes_transferred": 1,
    "http_method": "GET"
  }
]