- Docs
- Logging
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.
| Column | Details |
|---|---|
| Date | Start time of the action. |
| User | Username associated with the action. |
| Impersonator User | The 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. |
| Interface | API interface associated with the action. |
| API Key ID | Shows API key ID (if applicable). |
| API Key prefix | Shows API key prefix (if applicable). |
| API Name | Name of the API endpoint. |
| Request Method | HTTP method associated with the action. |
| Path | API request path. |
| Request IP | IP address of the requesting client. |
| Request-ID | Unique ID of the request. |
| Request Host | Hostname the request was sent to. |
| Response Code | HTTP response code sent. |
| User Agent | User-agent details of the requesting client. |
| Error Type | Error type, if available. |
| Error Message | Error message details, if available. |
| Status | Status such as Success or Failure for each API request. Shows as failure if the HTTP response code is 4xx or 5xx. |
| Duration | Time 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