API Logs
Files.com provides a detailed audit log of API requests made to your site using any interface type. This log includes every operation performed on your site.
We currently retain these logs for 30 days, but we are gradually increasing this to 180 days, with the 180-day retention expected to be in place by 2025.
Below are the details available in API logs. Columns such as User, Interface, Method, Request-ID, and Status can be filterable within a specific date range.
| Column | Details |
|---|---|
| Date | Start time of the action. |
| User | Username associated with the action. |
| 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. |
| Method | HTTP method associated with the action. |
| Path | API request path. |
| 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. |
| 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.