Skip to main content

4.25. Organisation Administrator - View organisation audit logs

Id 4.25.
Description

As an Organisation Administrator,

 

I want to have access to audit logs of all the actions perform by the users assigned to my organisation

 

So that I can find out what actions have been performed in the system and by whom
Priority Low
Actors Organisation Administrator
API Calls

GET /audit-logs

GET /audit-logs/<audit_log_id>
Linked Processes
Status Implemented

Preconditions

  1. The User must be authenticated and have the Organisation Administrator role.

Postconditions

  1. The System returns the list of audit logs that are linked to users that belong to the Organisation Administrator’s organisation.

Main flow

  1. The Organisation Administrator retrieves the audit logs using the API (GET). Optionally the Organisation Administrator can filter logs linked to to a specific:

    • user of the Organisation Administrator’s organisation
    • site
    • block
    • unit

    The user can also specify a time range of interest.

  2. The system validates the request parameters.

  3. The system returns the list of audit logs that match the query and are linked to the Organisation Administrator’s organisation.

Exceptions

[400 Bad Request] Invalid input:

If mandatory fields are missing or invalid, the system returns an error message.

[404 Not found] Data not found

If the Organisation Administrator attempts to retrieve audit logs using filters for resources that do not exist or belong to another organisation, the system will return an error.

[500 Internal Server Error] System Error

If the system fails to save changes due to an internal error, it displays an appropriate message and logs the error for further investigation.

No comments to display

Back to top