Query for Audit events
POST/audit_events/query
This endpoint provides a search engine for Audit Events by optionally combining subject_type, type, and subject_id to narrow down the audit events. A Subject Type of Profile links up to the AuditableProfile types. An Subject Type of WorkflowSession links up to the AuditableWorkflow types. An Subject Type of Get/Post/Patch/Delete links up to the AuditableApi types. The remaining Subject Types link up to the ActiveRecord types (configuration changes). Any workflow audit event created as of 10/11/2024 will be able to be queried by workflow name, workflow uid, or workflow profile type. Any profile audit event created as of 10/11/2024 will be able to be queried by profile type. The entity_type parameter has been updated to subject_type, which now matches what is in the response object. With the additional query filters added, there is a max of 5 filter parameters at one time (aside from pagination parameters). To accommodate these changes, an API contract change was required. Please read the updated API documentation for the new request syntax.
Request
- application/json
Body
required
audit_events
object
The page of pagination for these events.
A column that we are sorting these records from.
The limiting count for the amount of records returned.
Possible values: [asc
, desc
]
Which direction the list should be sorted by
filters
object
Possible values: [Profile
, WorkflowSession
, Email
, FormAttributeForm
, FormAttribute
, Form
, IdproxyPermission
, NeAttributeOption
, NeAttribute
, Notification
, Page
, Permission
, PortalRegistrationWorkflow
, Portal
, ProfileTypeRole
, ProfileType
, RoleProfile
, NeprofileRole
, NeaccessRole
, IdproxyRole
, SecurityQuestion
, UserManager
, UserProfile
, UserRole
, User
, Validation
, VerificationEmail
, WorkflowAction
, CreateWorkflow
, UpdateWorkflow
, AutomatedWorkflow
, BatchWorkflow
, ExpirationWorkflow
, InvitationWorkflow
, LoginWorkflow
, PasswordResetWorkflow
, RegistrationWorkflow
, Get
, Post
, Patch
, Delete
]
Categorization of audit event.
Possible values: [AuditableProfileCreate
, AuditableProfileUpdate
, AuditableProfileDestroy
, AuditableBulkProfileUpdate
, AuditableProfileContributorAdd
, AuditableProfileContributorRemove
, AuditableProfileContributorRoleAdd
, AuditableProfileContributorRoleRemove
, AuditableProfileOwnerUpdate
, AuditableProfileWorkflowEvent
, AuditableWorkflowActionSkippedEvent
, AuditableWorkflowApprovedEvent
, AuditableWorkflowApprovedEvent
, AuditableWorkflowAssignedEvent
, AuditableWorkflowAutoAssignedEvent
, AuditableWorkflowBatchCompleteEvent
, AuditableWorkflowClosedEvent
, AuditableWorkflowDuplicateCheckStartEvent
, AuditableWorkflowDuplicateResolutionEvent
, AuditableWorkflowFailedEvent
, AuditableWorkflowIdentityProofedEvent
, AuditableWorkflowInvitationSentEvent
, AuditableWorkflowLdapProvidedEvent
, AuditableWorkflowNotificationSentEvent
, AuditableWorkflowPendingApprovalEvent
, AuditableWorkflowPendingAssignmentEvent
, AuditableWorkflowPendingFulfillmentEvent
, AuditableWorkflowFulfilledEvent
, AuditableWorkflowPendingIdentityProofEvent
, AuditableWorkflowPendingLdapEvent
, AuditableWorkflowPendingRequestEvent
, AuditableWorkflowPendingReviewEvent
, AuditableWorkflowProfileCreatedEvent
, AuditableWorkflowProfileSelectEvent
, AuditableWorkflowProfileUpdatedEvent
, AuditableWorkflowRejectedEvent
, AuditableWorkflowRequestMadeEvent
, AuditableWorkflowRestApiEvent
, AuditableWorkflowReviewedEvent
, AuditableWorkflowRunningWorkflowEvent
, AuditableWorkflowSoapApiEvent
, AuditableWorkflowStatusChangedEvent
, AuditableWorkflowStoredProcedureEvent
, AuditableWorkflowUnassignEvent
, AuditableWorkflowWaitingForWorkflowEvent
, AuditableWorkflowWorkflowChangedEvent
, ActiveRecordCreate
, ActiveRecordUpdate
, ActiveRecordDestroy
, AuditableApiEvent
]
The type of audit event
Identifier of the subject
data
object
The profile id associated with the event
The workflow id associated with the event
The workflow name associated with the event
The workflow uid associated with the event
The profile type associated with the event
Responses
- 200
- 400
- 500
AuditEvents
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
audit_events
object[]
Possible values: [Profile
, WorkflowSession
, Email
, FormAttributeForm
, FormAttribute
, Form
, IdproxyPermission
, NeAttributeOption
, NeAttribute
, Notification
, Page
, Permission
, PortalRegistrationWorkflow
, Portal
, ProfileTypeRole
, ProfileType
, RoleProfile
, NeprofileRole
, NeaccessRole
, IdproxyRole
, SecurityQuestion
, UserManager
, UserProfile
, UserRole
, User
, Validation
, VerificationEmail
, WorkflowAction
, CreateWorkflow
, UpdateWorkflow
, AutomatedWorkflow
, BatchWorkflow
, ExpirationWorkflow
, InvitationWorkflow
, LoginWorkflow
, PasswordResetWorkflow
, RegistrationWorkflow
, Get
, Post
, Patch
, Delete
]
Categorization of audit event.
Possible values: [AuditableProfileCreate
, AuditableProfileUpdate
, AuditableProfileDestroy
, AuditableBulkProfileUpdate
, AuditableProfileContributorAdd
, AuditableProfileContributorRemove
, AuditableProfileContributorRoleAdd
, AuditableProfileContributorRoleRemove
, AuditableProfileOwnerUpdate
, AuditableProfileWorkflowEvent
, AuditableWorkflowActionSkippedEvent
, AuditableWorkflowApprovedEvent
, AuditableWorkflowApprovedEvent
, AuditableWorkflowAssignedEvent
, AuditableWorkflowAutoAssignedEvent
, AuditableWorkflowBatchCompleteEvent
, AuditableWorkflowClosedEvent
, AuditableWorkflowDuplicateCheckStartEvent
, AuditableWorkflowDuplicateResolutionEvent
, AuditableWorkflowFailedEvent
, AuditableWorkflowIdentityProofedEvent
, AuditableWorkflowInvitationSentEvent
, AuditableWorkflowLdapProvidedEvent
, AuditableWorkflowNotificationSentEvent
, AuditableWorkflowPendingApprovalEvent
, AuditableWorkflowPendingAssignmentEvent
, AuditableWorkflowPendingFulfillmentEvent
, AuditableWorkflowFulfilledEvent
, AuditableWorkflowPendingIdentityProofEvent
, AuditableWorkflowPendingLdapEvent
, AuditableWorkflowPendingRequestEvent
, AuditableWorkflowPendingReviewEvent
, AuditableWorkflowProfileCreatedEvent
, AuditableWorkflowProfileSelectEvent
, AuditableWorkflowProfileUpdatedEvent
, AuditableWorkflowRejectedEvent
, AuditableWorkflowRequestMadeEvent
, AuditableWorkflowRestApiEvent
, AuditableWorkflowReviewedEvent
, AuditableWorkflowRunningWorkflowEvent
, AuditableWorkflowSoapApiEvent
, AuditableWorkflowStatusChangedEvent
, AuditableWorkflowStoredProcedureEvent
, AuditableWorkflowUnassignEvent
, AuditableWorkflowWaitingForWorkflowEvent
, AuditableWorkflowWorkflowChangedEvent
, ActiveRecordCreate
, ActiveRecordUpdate
, ActiveRecordDestroy
, AuditableApiEvent
]
The type of audit event
Identifier of the subject
data
object
The profile id associated with the event
The workflow id associated with the event
The workflow name associated with the event
The workflow uid associated with the event
The profile type associated with the event
{
"audit_events": [
{
"subject_type": "Profile",
"type": "AuditableProfileCreate",
"subject_id": "7d8c53ca-e99d-485c-9524-ea3849e82c79",
"data": {
"profile_id": "7d8c53ca-e99d-485c-9524-ea3849e82c79",
"workflow_id": "7d8c53ca-e99d-485c-9524-ea3849e82c79",
"workflow_name": "My Workflow",
"workflow_uid": "my_workflow",
"profile_type_id": "7d8c53ca-e99d-485c-9524-ea3849e82c79"
}
}
]
}
Bad Request - unable to complete.
- application/json
- Schema
- Example (from schema)
Schema
- InvalidJson
- ValidationErrors
oneOf
{}
Internal Server Error - returned on unhandled exceptions.
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
{
"error": "Sorry something went wrong"
}