audit

GET /inventory/audit/history

Get Audit History

Retrieves paginated firmware upload audit logs with optional sorting. Requires CONTROL_CENTER_VIEW permission.

Query Parameters:

• page (integer) – Page number (default: 1)

• limit (integer) – Records per page (default: 20, max: 100)

• sort (string) – Sort field: created_at, filename, file_size, validation_status, user_id, ip_address

• order (string) – Sort order: asc, desc (default: desc)

Status Codes:

• 200 OK – OK

• 400 Bad Request – Invalid query parameters

• 500 Internal Server Error – Database error

Response JSON Object:

• data[].computed_checksum (string)

• data[].created_at (string)

• data[].event_type (string)

• data[].file_size (integer)

• data[].filename (string)

• data[].id (integer)

• data[].ip_address (string)

• data[].user_id (string)

• data[].validation_status (string)

• data[].vendor_checksum (string)

• message (string)

• pagination.has_next (boolean)

• pagination.has_prev (boolean)

• pagination.limit (integer)

• pagination.page (integer)

• pagination.total (integer)

• pagination.total_pages (integer)

• status (string)

GET /inventory/audit/history/by-file/{filename}

Get Audit History by File

Retrieves paginated audit logs for a specific firmware file. Requires CONTROL_CENTER_VIEW permission.

Parameters:

• filename (string) – Firmware filename

Query Parameters:

• page (integer) – Page number (default: 1)

• limit (integer) – Records per page (default: 20, max: 100)

• sort (string) – Sort field: created_at, filename, file_size, validation_status, user_id, ip_address

• order (string) – Sort order: asc, desc (default: desc)

Status Codes:

• 200 OK – OK

• 400 Bad Request – Invalid parameters

• 500 Internal Server Error – Database error

Response JSON Object:

• data[].computed_checksum (string)

• data[].created_at (string)

• data[].event_type (string)

• data[].file_size (integer)

• data[].filename (string)

• data[].id (integer)

• data[].ip_address (string)

• data[].user_id (string)

• data[].validation_status (string)

• data[].vendor_checksum (string)

• message (string)

• pagination.has_next (boolean)

• pagination.has_prev (boolean)

• pagination.limit (integer)

• pagination.page (integer)

• pagination.total (integer)

• pagination.total_pages (integer)

• status (string)

GET /inventory/audit/history/by-user/{user_id}

Get Audit History by User

Retrieves paginated audit logs for uploads by a specific user. Requires CONTROL_CENTER_VIEW permission.

Parameters:

• user_id (string) – User ID/Email

Query Parameters:

• page (integer) – Page number (default: 1)

• limit (integer) – Records per page (default: 20, max: 100)

• sort (string) – Sort field: created_at, filename, file_size, validation_status, user_id, ip_address

• order (string) – Sort order: asc, desc (default: desc)

Status Codes:

• 200 OK – OK

• 400 Bad Request – Invalid parameters

• 500 Internal Server Error – Database error

Response JSON Object:

• data[].computed_checksum (string)

• data[].created_at (string)

• data[].event_type (string)

• data[].file_size (integer)

• data[].filename (string)

• data[].id (integer)

• data[].ip_address (string)

• data[].user_id (string)

• data[].validation_status (string)

• data[].vendor_checksum (string)

• message (string)

• pagination.has_next (boolean)

• pagination.has_prev (boolean)

• pagination.limit (integer)

• pagination.page (integer)

• pagination.total (integer)

• pagination.total_pages (integer)

• status (string)