filescom-api-request-logs

An ApiRequestLog is an audit log for monitoring and troubleshooting requests made via API to your site.

Logs available through this endpoint are retained for 6 months, after which they are automatically discarded. For longer retention, use Files.com SIEM integrations to stream logs in real time to your preferred SIEM, or configure SIEM streaming to a file.

All subcommands also accept the flags documented in CONTEXT.md (--api-key, --format, --workspace-id, --debug, and the pagination flags --cursor / --per-page / --max-pages on list). Those are not repeated below.

Commands

files-cli api-request-logs list

List API Request Logs.

Flag	Type	Description
--filter	object	If set, return records where the specified field is equal to the supplied value. Valid fields are api_key_id, interface, request_id, request_ip, request_method, success, user_id or created_at. Valid field combinations are [ api_key_id ], [ interface ], [ request_id ], [ request_ip ], [ request_method ], [ success ], [ user_id ], [ created_at ], [ api_key_id, interface ], [ api_key_id, request_id ], [ api_key_id, request_ip ], [ api_key_id, request_method ], [ api_key_id, success ], [ api_key_id, user_id ], [ api_key_id, created_at ], [ interface, request_id ], [ interface, request_ip ], [ interface, request_method ], [ interface, success ], [ interface, user_id ], [ interface, created_at ], [ request_id, request_ip ], [ request_id, request_method ], [ request_id, success ], [ request_id, user_id ], [ request_id, created_at ], [ request_ip, request_method ], [ request_ip, success ], [ request_ip, user_id ], [ request_ip, created_at ], [ request_method, success ], [ request_method, user_id ], [ request_method, created_at ], [ success, user_id ], [ success, created_at ], [ user_id, created_at ], [ api_key_id, interface, request_id ], [ api_key_id, interface, request_ip ], [ api_key_id, interface, request_method ], [ api_key_id, interface, success ], [ api_key_id, interface, user_id ], [ api_key_id, interface, created_at ], [ api_key_id, request_id, request_ip ], [ api_key_id, request_id, request_method ], [ api_key_id, request_id, success ], [ api_key_id, request_id, user_id ], [ api_key_id, request_id, created_at ], [ api_key_id, request_ip, request_method ], [ api_key_id, request_ip, success ], [ api_key_id, request_ip, user_id ], [ api_key_id, request_ip, created_at ], [ api_key_id, request_method, success ], [ api_key_id, request_method, user_id ], [ api_key_id, request_method, created_at ], [ api_key_id, success, user_id ], [ api_key_id, success, created_at ], [ api_key_id, user_id, created_at ], [ interface, request_id, request_ip ], [ interface, request_id, request_method ], [ interface, request_id, success ], [ interface, request_id, user_id ], [ interface, request_id, created_at ], [ interface, request_ip, request_method ], [ interface, request_ip, success ], [ interface, request_ip, user_id ], [ interface, request_ip, created_at ], [ interface, request_method, success ], [ interface, request_method, user_id ], [ interface, request_method, created_at ], [ interface, success, user_id ], [ interface, success, created_at ], [ interface, user_id, created_at ], [ request_id, request_ip, request_method ], [ request_id, request_ip, success ], [ request_id, request_ip, user_id ], [ request_id, request_ip, created_at ], [ request_id, request_method, success ], [ request_id, request_method, user_id ], [ request_id, request_method, created_at ], [ request_id, success, user_id ], [ request_id, success, created_at ], [ request_id, user_id, created_at ], [ request_ip, request_method, success ], [ request_ip, request_method, user_id ], [ request_ip, request_method, created_at ], [ request_ip, success, user_id ], [ request_ip, success, created_at ], [ request_ip, user_id, created_at ], [ request_method, success, user_id ], [ request_method, success, created_at ], [ request_method, user_id, created_at ], [ success, user_id, created_at ], [ api_key_id, interface, request_id, request_ip ], [ api_key_id, interface, request_id, request_method ], [ api_key_id, interface, request_id, success ], [ api_key_id, interface, request_id, user_id ], [ api_key_id, interface, request_id, created_at ], [ api_key_id, interface, request_ip, request_method ], [ api_key_id, interface, request_ip, success ], [ api_key_id, interface, request_ip, user_id ], [ api_key_id, interface, request_ip, created_at ], [ api_key_id, interface, request_method, success ], [ api_key_id, interface, request_method, user_id ], [ api_key_id, interface, request_method, created_at ], [ api_key_id, interface, success, user_id ], [ api_key_id, interface, success, created_at ], [ api_key_id, interface, user_id, created_at ], [ api_key_id, request_id, request_ip, request_method ], [ api_key_id, request_id, request_ip, success ], [ api_key_id, request_id, request_ip, user_id ], [ api_key_id, request_id, request_ip, created_at ], [ api_key_id, request_id, request_method, success ], [ api_key_id, request_id, request_method, user_id ], [ api_key_id, request_id, request_method, created_at ], [ api_key_id, request_id, success, user_id ], [ api_key_id, request_id, success, created_at ], [ api_key_id, request_id, user_id, created_at ], [ api_key_id, request_ip, request_method, success ], [ api_key_id, request_ip, request_method, user_id ], [ api_key_id, request_ip, request_method, created_at ], [ api_key_id, request_ip, success, user_id ], [ api_key_id, request_ip, success, created_at ], [ api_key_id, request_ip, user_id, created_at ], [ api_key_id, request_method, success, user_id ], [ api_key_id, request_method, success, created_at ], [ api_key_id, request_method, user_id, created_at ], [ api_key_id, success, user_id, created_at ], [ interface, request_id, request_ip, request_method ], [ interface, request_id, request_ip, success ], [ interface, request_id, request_ip, user_id ], [ interface, request_id, request_ip, created_at ], [ interface, request_id, request_method, success ], [ interface, request_id, request_method, user_id ], [ interface, request_id, request_method, created_at ], [ interface, request_id, success, user_id ], [ interface, request_id, success, created_at ], [ interface, request_id, user_id, created_at ], [ interface, request_ip, request_method, success ], [ interface, request_ip, request_method, user_id ], [ interface, request_ip, request_method, created_at ], [ interface, request_ip, success, user_id ], [ interface, request_ip, success, created_at ], [ interface, request_ip, user_id, created_at ], [ interface, request_method, success, user_id ], [ interface, request_method, success, created_at ], [ interface, request_method, user_id, created_at ], [ interface, success, user_id, created_at ], [ request_id, request_ip, request_method, success ], [ request_id, request_ip, request_method, user_id ], [ request_id, request_ip, request_method, created_at ], [ request_id, request_ip, success, user_id ], [ request_id, request_ip, success, created_at ], [ request_id, request_ip, user_id, created_at ], [ request_id, request_method, success, user_id ], [ request_id, request_method, success, created_at ], [ request_id, request_method, user_id, created_at ], [ request_id, success, user_id, created_at ], [ request_ip, request_method, success, user_id ], [ request_ip, request_method, success, created_at ], [ request_ip, request_method, user_id, created_at ], [ request_ip, success, user_id, created_at ], [ request_method, success, user_id, created_at ], [ api_key_id, interface, request_id, request_ip, request_method ], [ api_key_id, interface, request_id, request_ip, success ], [ api_key_id, interface, request_id, request_ip, user_id ], [ api_key_id, interface, request_id, request_ip, created_at ], [ api_key_id, interface, request_id, request_method, success ], [ api_key_id, interface, request_id, request_method, user_id ], [ api_key_id, interface, request_id, request_method, created_at ], [ api_key_id, interface, request_id, success, user_id ], [ api_key_id, interface, request_id, success, created_at ], [ api_key_id, interface, request_id, user_id, created_at ], [ api_key_id, interface, request_ip, request_method, success ], [ api_key_id, interface, request_ip, request_method, user_id ], [ api_key_id, interface, request_ip, request_method, created_at ], [ api_key_id, interface, request_ip, success, user_id ], [ api_key_id, interface, request_ip, success, created_at ], [ api_key_id, interface, request_ip, user_id, created_at ], [ api_key_id, interface, request_method, success, user_id ], [ api_key_id, interface, request_method, success, created_at ], [ api_key_id, interface, request_method, user_id, created_at ], [ api_key_id, interface, success, user_id, created_at ], [ api_key_id, request_id, request_ip, request_method, success ], [ api_key_id, request_id, request_ip, request_method, user_id ], [ api_key_id, request_id, request_ip, request_method, created_at ], [ api_key_id, request_id, request_ip, success, user_id ], [ api_key_id, request_id, request_ip, success, created_at ], [ api_key_id, request_id, request_ip, user_id, created_at ], [ api_key_id, request_id, request_method, success, user_id ], [ api_key_id, request_id, request_method, success, created_at ], [ api_key_id, request_id, request_method, user_id, created_at ], [ api_key_id, request_id, success, user_id, created_at ], [ api_key_id, request_ip, request_method, success, user_id ], [ api_key_id, request_ip, request_method, success, created_at ], [ api_key_id, request_ip, request_method, user_id, created_at ], [ api_key_id, request_ip, success, user_id, created_at ], [ api_key_id, request_method, success, user_id, created_at ], [ interface, request_id, request_ip, request_method, success ], [ interface, request_id, request_ip, request_method, user_id ], [ interface, request_id, request_ip, request_method, created_at ], [ interface, request_id, request_ip, success, user_id ], [ interface, request_id, request_ip, success, created_at ], [ interface, request_id, request_ip, user_id, created_at ], [ interface, request_id, request_method, success, user_id ], [ interface, request_id, request_method, success, created_at ], [ interface, request_id, request_method, user_id, created_at ], [ interface, request_id, success, user_id, created_at ], [ interface, request_ip, request_method, success, user_id ], [ interface, request_ip, request_method, success, created_at ], [ interface, request_ip, request_method, user_id, created_at ], [ interface, request_ip, success, user_id, created_at ], [ interface, request_method, success, user_id, created_at ], [ request_id, request_ip, request_method, success, user_id ], [ request_id, request_ip, request_method, success, created_at ], [ request_id, request_ip, request_method, user_id, created_at ], [ request_id, request_ip, success, user_id, created_at ], [ request_id, request_method, success, user_id, created_at ], [ request_ip, request_method, success, user_id, created_at ], [ api_key_id, interface, request_id, request_ip, request_method, success ], [ api_key_id, interface, request_id, request_ip, request_method, user_id ], [ api_key_id, interface, request_id, request_ip, request_method, created_at ], [ api_key_id, interface, request_id, request_ip, success, user_id ], [ api_key_id, interface, request_id, request_ip, success, created_at ], [ api_key_id, interface, request_id, request_ip, user_id, created_at ], [ api_key_id, interface, request_id, request_method, success, user_id ], [ api_key_id, interface, request_id, request_method, success, created_at ], [ api_key_id, interface, request_id, request_method, user_id, created_at ], [ api_key_id, interface, request_id, success, user_id, created_at ], [ api_key_id, interface, request_ip, request_method, success, user_id ], [ api_key_id, interface, request_ip, request_method, success, created_at ], [ api_key_id, interface, request_ip, request_method, user_id, created_at ], [ api_key_id, interface, request_ip, success, user_id, created_at ], [ api_key_id, interface, request_method, success, user_id, created_at ], [ api_key_id, request_id, request_ip, request_method, success, user_id ], [ api_key_id, request_id, request_ip, request_method, success, created_at ], [ api_key_id, request_id, request_ip, request_method, user_id, created_at ], [ api_key_id, request_id, request_ip, success, user_id, created_at ], [ api_key_id, request_id, request_method, success, user_id, created_at ], [ api_key_id, request_ip, request_method, success, user_id, created_at ], [ interface, request_id, request_ip, request_method, success, user_id ], [ interface, request_id, request_ip, request_method, success, created_at ], [ interface, request_id, request_ip, request_method, user_id, created_at ], [ interface, request_id, request_ip, success, user_id, created_at ], [ interface, request_id, request_method, success, user_id, created_at ], [ interface, request_ip, request_method, success, user_id, created_at ], [ request_id, request_ip, request_method, success, user_id, created_at ], [ api_key_id, interface, request_id, request_ip, request_method, success, user_id ], [ api_key_id, interface, request_id, request_ip, request_method, success, created_at ], [ api_key_id, interface, request_id, request_ip, request_method, user_id, created_at ], [ api_key_id, interface, request_id, request_ip, success, user_id, created_at ], [ api_key_id, interface, request_id, request_method, success, user_id, created_at ], [ api_key_id, interface, request_ip, request_method, success, user_id, created_at ], [ api_key_id, request_id, request_ip, request_method, success, user_id, created_at ], [ interface, request_id, request_ip, request_method, success, user_id, created_at ] or [ api_key_id, interface, request_id, request_ip, request_method, success, user_id, created_at ].
--filter-gt	object	If set, return records where the specified field is greater than the supplied value. Valid fields are created_at. Valid field combinations are [ api_key_id ], [ interface ], [ request_id ], [ request_ip ], [ request_method ], [ success ], [ user_id ], [ created_at ], [ api_key_id, interface ], [ api_key_id, request_id ], [ api_key_id, request_ip ], [ api_key_id, request_method ], [ api_key_id, success ], [ api_key_id, user_id ], [ api_key_id, created_at ], [ interface, request_id ], [ interface, request_ip ], [ interface, request_method ], [ interface, success ], [ interface, user_id ], [ interface, created_at ], [ request_id, request_ip ], [ request_id, request_method ], [ request_id, success ], [ request_id, user_id ], [ request_id, created_at ], [ request_ip, request_method ], [ request_ip, success ], [ request_ip, user_id ], [ request_ip, created_at ], [ request_method, success ], [ request_method, user_id ], [ request_method, created_at ], [ success, user_id ], [ success, created_at ], [ user_id, created_at ], [ api_key_id, interface, request_id ], [ api_key_id, interface, request_ip ], [ api_key_id, interface, request_method ], [ api_key_id, interface, success ], [ api_key_id, interface, user_id ], [ api_key_id, interface, created_at ], [ api_key_id, request_id, request_ip ], [ api_key_id, request_id, request_method ], [ api_key_id, request_id, success ], [ api_key_id, request_id, user_id ], [ api_key_id, request_id, created_at ], [ api_key_id, request_ip, request_method ], [ api_key_id, request_ip, success ], [ api_key_id, request_ip, user_id ], [ api_key_id, request_ip, created_at ], [ api_key_id, request_method, success ], [ api_key_id, request_method, user_id ], [ api_key_id, request_method, created_at ], [ api_key_id, success, user_id ], [ api_key_id, success, created_at ], [ api_key_id, user_id, created_at ], [ interface, request_id, request_ip ], [ interface, request_id, request_method ], [ interface, request_id, success ], [ interface, request_id, user_id ], [ interface, request_id, created_at ], [ interface, request_ip, request_method ], [ interface, request_ip, success ], [ interface, request_ip, user_id ], [ interface, request_ip, created_at ], [ interface, request_method, success ], [ interface, request_method, user_id ], [ interface, request_method, created_at ], [ interface, success, user_id ], [ interface, success, created_at ], [ interface, user_id, created_at ], [ request_id, request_ip, request_method ], [ request_id, request_ip, success ], [ request_id, request_ip, user_id ], [ request_id, request_ip, created_at ], [ request_id, request_method, success ], [ request_id, request_method, user_id ], [ request_id, request_method, created_at ], [ request_id, success, user_id ], [ request_id, success, created_at ], [ request_id, user_id, created_at ], [ request_ip, request_method, success ], [ request_ip, request_method, user_id ], [ request_ip, request_method, created_at ], [ request_ip, success, user_id ], [ request_ip, success, created_at ], [ request_ip, user_id, created_at ], [ request_method, success, user_id ], [ request_method, success, created_at ], [ request_method, user_id, created_at ], [ success, user_id, created_at ], [ api_key_id, interface, request_id, request_ip ], [ api_key_id, interface, request_id, request_method ], [ api_key_id, interface, request_id, success ], [ api_key_id, interface, request_id, user_id ], [ api_key_id, interface, request_id, created_at ], [ api_key_id, interface, request_ip, request_method ], [ api_key_id, interface, request_ip, success ], [ api_key_id, interface, request_ip, user_id ], [ api_key_id, interface, request_ip, created_at ], [ api_key_id, interface, request_method, success ], [ api_key_id, interface, request_method, user_id ], [ api_key_id, interface, request_method, created_at ], [ api_key_id, interface, success, user_id ], [ api_key_id, interface, success, created_at ], [ api_key_id, interface, user_id, created_at ], [ api_key_id, request_id, request_ip, request_method ], [ api_key_id, request_id, request_ip, success ], [ api_key_id, request_id, request_ip, user_id ], [ api_key_id, request_id, request_ip, created_at ], [ api_key_id, request_id, request_method, success ], [ api_key_id, request_id, request_method, user_id ], [ api_key_id, request_id, request_method, created_at ], [ api_key_id, request_id, success, user_id ], [ api_key_id, request_id, success, created_at ], [ api_key_id, request_id, user_id, created_at ], [ api_key_id, request_ip, request_method, success ], [ api_key_id, request_ip, request_method, user_id ], [ api_key_id, request_ip, request_method, created_at ], [ api_key_id, request_ip, success, user_id ], [ api_key_id, request_ip, success, created_at ], [ api_key_id, request_ip, user_id, created_at ], [ api_key_id, request_method, success, user_id ], [ api_key_id, request_method, success, created_at ], [ api_key_id, request_method, user_id, created_at ], [ api_key_id, success, user_id, created_at ], [ interface, request_id, request_ip, request_method ], [ interface, request_id, request_ip, success ], [ interface, request_id, request_ip, user_id ], [ interface, request_id, request_ip, created_at ], [ interface, request_id, request_method, success ], [ interface, request_id, request_method, user_id ], [ interface, request_id, request_method, created_at ], [ interface, request_id, success, user_id ], [ interface, request_id, success, created_at ], [ interface, request_id, user_id, created_at ], [ interface, request_ip, request_method, success ], [ interface, request_ip, request_method, user_id ], [ interface, request_ip, request_method, created_at ], [ interface, request_ip, success, user_id ], [ interface, request_ip, success, created_at ], [ interface, request_ip, user_id, created_at ], [ interface, request_method, success, user_id ], [ interface, request_method, success, created_at ], [ interface, request_method, user_id, created_at ], [ interface, success, user_id, created_at ], [ request_id, request_ip, request_method, success ], [ request_id, request_ip, request_method, user_id ], [ request_id, request_ip, request_method, created_at ], [ request_id, request_ip, success, user_id ], [ request_id, request_ip, success, created_at ], [ request_id, request_ip, user_id, created_at ], [ request_id, request_method, success, user_id ], [ request_id, request_method, success, created_at ], [ request_id, request_method, user_id, created_at ], [ request_id, success, user_id, created_at ], [ request_ip, request_method, success, user_id ], [ request_ip, request_method, success, created_at ], [ request_ip, request_method, user_id, created_at ], [ request_ip, success, user_id, created_at ], [ request_method, success, user_id, created_at ], [ api_key_id, interface, request_id, request_ip, request_method ], [ api_key_id, interface, request_id, request_ip, success ], [ api_key_id, interface, request_id, request_ip, user_id ], [ api_key_id, interface, request_id, request_ip, created_at ], [ api_key_id, interface, request_id, request_method, success ], [ api_key_id, interface, request_id, request_method, user_id ], [ api_key_id, interface, request_id, request_method, created_at ], [ api_key_id, interface, request_id, success, user_id ], [ api_key_id, interface, request_id, success, created_at ], [ api_key_id, interface, request_id, user_id, created_at ], [ api_key_id, interface, request_ip, request_method, success ], [ api_key_id, interface, request_ip, request_method, user_id ], [ api_key_id, interface, request_ip, request_method, created_at ], [ api_key_id, interface, request_ip, success, user_id ], [ api_key_id, interface, request_ip, success, created_at ], [ api_key_id, interface, request_ip, user_id, created_at ], [ api_key_id, interface, request_method, success, user_id ], [ api_key_id, interface, request_method, success, created_at ], [ api_key_id, interface, request_method, user_id, created_at ], [ api_key_id, interface, success, user_id, created_at ], [ api_key_id, request_id, request_ip, request_method, success ], [ api_key_id, request_id, request_ip, request_method, user_id ], [ api_key_id, request_id, request_ip, request_method, created_at ], [ api_key_id, request_id, request_ip, success, user_id ], [ api_key_id, request_id, request_ip, success, created_at ], [ api_key_id, request_id, request_ip, user_id, created_at ], [ api_key_id, request_id, request_method, success, user_id ], [ api_key_id, request_id, request_method, success, created_at ], [ api_key_id, request_id, request_method, user_id, created_at ], [ api_key_id, request_id, success, user_id, created_at ], [ api_key_id, request_ip, request_method, success, user_id ], [ api_key_id, request_ip, request_method, success, created_at ], [ api_key_id, request_ip, request_method, user_id, created_at ], [ api_key_id, request_ip, success, user_id, created_at ], [ api_key_id, request_method, success, user_id, created_at ], [ interface, request_id, request_ip, request_method, success ], [ interface, request_id, request_ip, request_method, user_id ], [ interface, request_id, request_ip, request_method, created_at ], `[ interface, re