orchestrator
2021.10
false
- Getting Started
 - Authentication
 - Swagger Definition
 - Orchestrator APIs
- Alerts Requests
 - Assets Requests
 - Calendars Requests
 - Environments Requests
 - Folders Requests
 - Generic Tasks Requests
 - Jobs Requests
 - Libraries Requests
 - License Requests
 - Packages Requests
 - Permissions Requests
 - Processes Requests
 - Robots Requests
 - Roles Requests
 - Schedules Requests
 - Settings Requests
 - Tasks Requests
 - Task Catalogs Requests
 - Task Forms Requests
 - Tenants Requests
 - Transactions Requests
 - Users Requests
 - Webhooks Requests
 
 - Platform Management APIs
- Get Audit Logs
 - Download Audit Logs
 
 

OUT OF SUPPORT
Orchestrator API Guide
Last updated Oct 31, 2024
Gets the audit logs for an organization, based on the organization name.
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'| 
                               Query param  | 
                               Data type  | 
                               Description  | 
|---|---|---|
| 
                               
 (optional)  | 
                               string  | 
                               Specify the available display language, in the shorten form. For example,  
                              
                              
                           en, fr, de, ja etc.
                               | 
| 
                               
 (optional)  | 
                               int32  | 
                               Display the top N entries of the audit.  | 
| 
                               
 (optional)  | 
                               int32  | 
                               Skip the top N audit entries from displaying.  | 
| 
                               
 (optional)  | 
                               string  | 
                               Specify the DTO property used to sort audit entries by. For example,  
                              
                              
                           createdOn, category, email, etc.
                               | 
| 
                               
 (optional)  | 
                               string  | 
                               Specify the sorting order. For example, ascending ( 
                              
                              
                           asc) or descending (desc).
                               | 
| 
                               
 (optional)  | 
                               string  | 
                               Specify the API version you are using.  | 
Let's say you gathered all the information needed to build the API call.
- Your 
{baseURL}is:https://{yourDomain}/{organizationName}/{tenantName}/ - 
                     				
                     Your
{access_token}is:1234(for length considerations). - 
                     				
                     
You set the following query params:
- 
                           						
language=en - 
                           						
top= 2, to display the top two entries - 
                           						
skip= 2, to skip the first two entries - 
                           						
sortBy=createdOn, to sort the entries by their creation time - 
                           						
sortOrder=asc, to sort the entries from the earliest entry to the latest one 
 - 
                           						
 
The call should look like below (cURL):
curl --location --request GET '
				https://{yourDomain}/{organizationName}/{tenantName}/audit_/api/auditlogs/?language=en&top=2&skip=2&sortBy=createdOn&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'curl --location --request GET '
				https://{yourDomain}/{organizationName}/{tenantName}/audit_/api/auditlogs/?language=en&top=2&skip=2&sortBy=createdOn&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'Here's the response body for a successful audit entries retrieval:
{
    "totalCount": 29,
    "results": [
        {
            "createdOn": "2021-10-14T13:10:15.1964174+00:00",
            "category": "User",
            "action": "Login",
            "auditLogDetails": "{\r\n \"userName\": \"System Administrator admin\",\r\n \"email\": \"\"\r\n}", 
            "userName": "System Administrator",
            "email": "",
            "message": "User 'System Administrator admin' logged in",
            "detailsVersion": "1.0",
            "source": "Cis"
        },
....
        {
            "createdOn": "2021-10-14T12:41:00.3268964+00:00",
            "category": "User",
            "action": "Login",
            "auditLogDetails": "{\r\n \"userName\": \"System Administrator admin\",\r\n \"email\": \"\"\r\n}", 
            "userName": "System Administrator",
            "email": "",
            "message": "User 'System Administrator admin' logged in",
            "detailsVersion": "1.0",
            "source": "Cis"
        }
    ]
}{
    "totalCount": 29,
    "results": [
        {
            "createdOn": "2021-10-14T13:10:15.1964174+00:00",
            "category": "User",
            "action": "Login",
            "auditLogDetails": "{\r\n \"userName\": \"System Administrator admin\",\r\n \"email\": \"\"\r\n}", 
            "userName": "System Administrator",
            "email": "",
            "message": "User 'System Administrator admin' logged in",
            "detailsVersion": "1.0",
            "source": "Cis"
        },
....
        {
            "createdOn": "2021-10-14T12:41:00.3268964+00:00",
            "category": "User",
            "action": "Login",
            "auditLogDetails": "{\r\n \"userName\": \"System Administrator admin\",\r\n \"email\": \"\"\r\n}", 
            "userName": "System Administrator",
            "email": "",
            "message": "User 'System Administrator admin' logged in",
            "detailsVersion": "1.0",
            "source": "Cis"
        }
    ]
}