# BlueConic Audit Events API

**Canonical:** https://apis.io/apis/blueconic/blueconic-audit-events-api/  
**Provider:** BlueConic — https://apis.io/providers/blueconic/  
**Base URL:** https://{tenantname}.blueconic.net/rest/v2  
**Documentation:** https://support.blueconic.com/en/articles/248008-overview-blueconic-rest-api

BlueConic Audit Events API is one of 28 APIs that [BlueConic](https://apis.io/providers/blueconic/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Audit Events. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

The Audit Event API allows users to connect BlueConic to a SIEM system. We recommend using this API to periodically receive security-related activities based on a rolling window. The API has a 30-day retention period. The API logs the following audit events: | Object | Events | |:---------------------------|:-----------------------------------------------------------------------------------------------| | BlueConic hostname | Create, Update, Delete | | BlueConic Support Access | Update (for each change) | | Channel | Create, Update, Delete | | Clean up rule | Create, Update, Delete | | Connection | Create, Update, Delete, Manual run, Scheduled run | | Dashboard | Create, Update, Delete | | Dialogue | Create, Update, Delete | | Domain Group | Create, Update, Delete | | Gen AI Setting | Update (for each change) | | Group | Read, Update, Delete | | Group type | Create, Update, Delete | | Ip range | Create, Update, Delete | | Language | Create, Update, Delete | | Lifecycle | Create, Update, Delete | | Merge rule | Create, Update, Delete | | Models | Create, Update, Delete | | Notebook | Create, Update, Delete, Manual run, Scheduled run, Editor run | | OAuth application | Create, Update, Delete | | OAuth token | Create, Update, Delete | | Objective | Create, Update, Delete | | Plugin | Create, Update, Delete | | Privacy setting | Update (for each change) | | Profile | Read, Update, Delete | | Profile property | Create, Update, Delete | | Role | Create, Update, Delete | | Segment | Create, Update, Delete | | Single Sign On Setting | Update (for each change) | | Inactvity Setting | Update (for each change) | | Supported Legislation Zone | Create, Delete, Update | | Timeline Event Rollup | Create, Update, Delete | | Timeline Event Type | Create, Update, Delete | | Tracker | Create, Update, Delete | | User | Login, Login failed, Logout, Create, Update, Delete, Password reset requested, Password change | Only Profile and Group viewed, updated, or deleted by a user from the Profile and Groups tab are logged. The following events are not considered as human actions, and therefore not covered in the Platform Audit Event API: - Connections that import or export profiles. - Profile and group creation (Profiles can only be created by a visitor or an import connection). **Event data** The following event data is available: | Field | Description | Example values | | :--- | :--- |:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |date|Datetime in UTC when the event occurred. The date is in the https://www.ietf.org/rfc/rfc3339.txt format.| 2025-04-15T11:24:01.183Z | |username|(BlueConic) Identifier (email address) of the user who did the action.<br /><br />Value is empty for failed login attempts.| test@blueconic.com | |objectType|Object of the action.| <ul><li>BLUECONIC_HOSTNAME</li><li>BLUECONIC_SUPPORT_ACCESS_SETTING</li><li>CHANNEL</li><li>CLEAN_UP_RULE</li><li>CONNECTION</li><li>DASHBOARD</li><li>DIALOGUE</li><li>DOMAIN_GROUP</li><li>GEN_AI_SETTING</li><li>GROUP</li><li>GROUP_TYPE</li><li>IP_RANGE</li><li>LANGUAGE</li><li>LIFECYCLE</li><li>LISTENER</li><li>MERGE_RULE</li><li>NOTEBOOK</li><li>OBJECTIVE</li><li>PLUGIN</li><li>PRIVACY_SETTING</li><li>PROFILE</li><li>PROFILE_PROPERTY</li><li>ROLE</li><li>SEGMENT</li><li>SINGLE_SIGN_ON_SETTING</li><li>SUPPORTED_LEGISLATION_ZONE</li><li>TRACKER</li><li>USER</li></ul> | |objectId|<ul><li>Email address in case of a user. <ul><li>In the case of LOGIN_FAILED and a user tried to login with an invalid format email address, it could be that the user filled the password in the email address field. In that case the objectId is empty</li></ul></li><li>Grouptype_GroupID in case of a group</li><li> For PRIVACY_SETTING and SINGLE_SIGN_ON_SETTING, the objectId is the name(s) of the changed setting. E.g. Status, Identity_Provider_Issuer_URL_Entity_ID.</li><li> For BLUECONIC_SUPPORT_ACCESS_SETTING the objectID contains the new settings.<ul><li> `"objects" : [ {"name" : "No Access", "id" : "none" } ]` or </li><li>`"objects" : [ {"name" : "User name here", "id" : "user1@blueconic.com" },{"name" : "User name 2 here", "id" : "user2@blueconic.com" }], (contains the new list)` or</li><li>`"objects" : [ {"name" : "All BlueConic support employees", "id" : "all" } ],`</li></ul></li><li>UUID or identifier in case of other object types.</li></ul>| <ul><li>1b1e50a5-c46a-4309-a95c-d4e19985fbbb</li><li>test@blueconic.com</li><li>test_objective</li><li>test_profile_property</li></ul> | |objectName|<p>Human readable name of the object.</p><p>For Profiles, the name is determined by the first value that is not empty:</p><ol><li>fullname</li><li>email</li><li>BlueConic ID (UUID)</li></ol><p>For Users, the name is determined by the first value that is not empty:</p><ol><li>fullname</li><li>email</li></ol><ul><li>In the case of LOGIN_FAILED and a user tried to login with an invalid format email address, it could be that the user filled the password in the email address field. In that case, the objectName is empty.</li></ul><p>For groups, the name is the group id.</p><p><span>For PRIVACY_SETTING and SINGLE_SIGN_ON_SETTING, the objectName is the name(s) of the changed setting. E.g. Status, Identity_Provider_Issuer_URL_Entity_ID.</span></p><p>For BLUECONIC_SUPPORT_ACCESS_SETTING the objectName contains the new settings.</p><ul><li><p>`"objects" : [ {"name" : "No Access", "id" : "none" } ]` or</p></li><li ><p> `"objects" : [ {"name" : "User name here", "id" : "user1@blueconic.com" },{"name" : "User name 2 here", "id" : "user2@blueconic.com" }],` (contains the new list) or</p></li><li><p>`"objects" : [ {"name" : "All BlueConic support employees", "id" : "all" } ],`</p></li></ul>| <ul><li>SFTP connection</li><li>test@blueconic.om</li><li>Keyword Interest Ranking</li> | |operation| Action performed on the object. | <ul><li>CREATE</li><li>UPDATE</li><li>DELETE</li><li>EDITOR_RUN</li><li>READ</li><li>LOGIN</li><li>LOGIN_FAILED</li><li>LOGOUT</li><li>MANUAL_RUN</li><li>PASSWORD_RESET_REQUESTED</li><li>PASSWORD_CHANGE</li><li>SCHEDULED_RUN</li></ul> |ipAddress| The source IP address from which the event was triggered. | 192.168.1.100 | |application| The application that performed the audit event operation. | blueconic |

## Operations (1)

| Method | Path | Summary |
|---|---|---|
| GET | `/auditEvents` | Get audit events |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/blueconic/refs/heads/main/openapi/blueconic-audit-events-api-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/blueconic/refs/heads/main/overlays/blueconic-audit-events-api-overlay.yaml
- **Documentation** — https://support.blueconic.com/en/articles/248008-overview-blueconic-rest-api
- **GettingStarted** — https://support.blueconic.com/en/articles/248009-using-the-blueconic-rest-api-v2
- **Authentication** — https://support.blueconic.com/en/articles/247557-authorizing-applications-granting-external-applications-to-access-blueconic
- **AuthorizationCodeFlow** — https://support.blueconic.com/en/articles/247559-authorizing-applications-using-the-authorization-code-flow
- **ClientCredentialsFlow** — https://support.blueconic.com/en/articles/247558-authorizing-applications-using-the-client-credentials-flow
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/blueconic/refs/heads/main/apis.yml

## Other BlueConic APIs (12)

- [BlueConic Channels API](https://apis.io/apis/blueconic/blueconic-channels-api/)
- [BlueConic Connections API](https://apis.io/apis/blueconic/blueconic-connections-api/)
- [BlueConic Dialogues API](https://apis.io/apis/blueconic/blueconic-dialogues-api/)
- [BlueConic Group Types API](https://apis.io/apis/blueconic/blueconic-group-types-api/)
- [BlueConic Groups API](https://apis.io/apis/blueconic/blueconic-groups-api/)
- [BlueConic Interaction events API](https://apis.io/apis/blueconic/blueconic-interaction-events-api/)
- [BlueConic Interactions API](https://apis.io/apis/blueconic/blueconic-interactions-api/)
- [BlueConic Lifecycles API](https://apis.io/apis/blueconic/blueconic-lifecycles-api/)
- [BlueConic Listeners API](https://apis.io/apis/blueconic/blueconic-listeners-api/)
- [BlueConic Models API](https://apis.io/apis/blueconic/blueconic-models-api/)
- [BlueConic Notebooks API](https://apis.io/apis/blueconic/blueconic-notebooks-api/)
- [BlueConic OAuth 2.0 API](https://apis.io/apis/blueconic/blueconic-oauth-2-0-api/)

## Tags

Audit Events

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/blueconic/blueconic-audit-events-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/blueconic/.
