Skip to main content

API Logs

Files.com records a comprehensive audit log of all API requests made to your site, regardless of the interface used. This includes requests originating from web, desktop, mobile, file transfer protocols, integrations, automated systems, and inbound and outbound services.

Any request that reaches your site, including successful operations and failed attempts, is captured in the API logs.

We retain these logs for 180 days.

Details Recorded in API Logs

API logs contain critical information about activity, including the following details.

ColumnDetails
DateStart time of the action.
UserUsername associated with the action.
Impersonator UserThe username of the Site Administrator who initiated the impersonation for the request.
User from Parent Site?Displays Yes if the request is from a parent site.
InterfaceAPI interface associated with the action.
API Key IDShows API key ID (if applicable).
API Key prefixShows API key prefix (if applicable).
API NameName of the API endpoint.
Request MethodHTTP method associated with the action.
PathAPI request path.
Request IPIP address of the requesting client.
Request-IDUnique ID of the request.
Request HostHostname the request was sent to.
Response CodeHTTP response code sent.
User AgentUser-agent details of the requesting client.
Error TypeError type, if available.
Error MessageError message details, if available.
StatusStatus such as Success or Failure for each API request. Shows as failure if the HTTP response code is 4xx or 5xx.
DurationTime taken in milliseconds for the execution of the action.

Request-ID

The Request-ID uniquely identifies a single API request. When you need to contact Support about unexpected behavior, it's often helpful to locate the error in your API Logs first so that you can provide the relevant Request-ID for troubleshooting.

Get The File Orchestration Platform Today

4,000+ organizations trust Files.com for mission-critical file operations. Start your free trial now and build your first flow in 60 seconds.

No credit card required • 7-day free trial • Setup in minutes