Create Audit Log Destination

Creates a configuration for the audit log destination.

post

Body

application/json

The request schema to create an audit log destination.

namestringrequired

The name of the audit log destination.

Example:My Destination

endpointstringrequired

The endpoint that will receive audit log messages.

Example:https://example.com/audit-logs

authorizationstringrequired

The value to include in the Authorization header when sending audit logs to the webhook.

Example:Bearer sometoken

log_formatstringrequired

The output format of each log messages.

Allowed values:cefjsoncps

Default:cef

skip_ssl_verificationboolean

Indicates if the SSL certificate verification of the host endpoint should be skipped when delivering payloads.
We strongly recommend not setting this to ‘true’ as you are subject to man-in-the-middle and other attacks.
This option should be considered only for self-signed SSL certificates used in a non-production environment.

Default:false

Example:false

Response

application/json

Audit log destination response

AuditLogDestination

Audit Log Destination Schema

idstring(uuid)

The unique ID of the audit log destination.

namestring

The name of the audit log destination.

endpointstring

The endpoint that will receive audit log messages.

Example:https://example.com/audit-logs

log_formatstring

The output format of each log messages.

Allowed values:cefjsoncps

Default:cef

skip_ssl_verificationboolean

Indicates if the SSL certificate verification of the host endpoint should be skipped when delivering payloads.

Default:false

Example:false

created_atstring(date-time)read-only

Timestamp when this webhook was created.

updated_atstring(date-time)read-only

Timestamp when this webhook was last updated. Initial value is 0001-01-01T00:00:0Z.

post/audit-log-destinations

Body

{ "id": "07ec3858-066b-4629-bdc5-d4aa893b424d", "name": "My Destination", "endpoint": "https://example.com/audit-log", "authorization": "Bearer token", "log_format": "cef", "skip_ssl_verification": false }
 
application/json

Get Audit Log Destination

Returns configuration for the audit log destination.

get

Path Parameters

auditLogDestinationIdstring(uuid)required

ID of the Audit Log Destination.

Response

application/json

Audit log destination response

AuditLogDestination

Audit Log Destination Schema

idstring(uuid)

The unique ID of the audit log destination.

namestring

The name of the audit log destination.

endpointstring

The endpoint that will receive audit log messages.

Example:https://example.com/audit-logs

log_formatstring

The output format of each log messages.

Allowed values:cefjsoncps

Default:cef

skip_ssl_verificationboolean

Indicates if the SSL certificate verification of the host endpoint should be skipped when delivering payloads.

Default:false

Example:false

created_atstring(date-time)read-only

Timestamp when this webhook was created.

updated_atstring(date-time)read-only

Timestamp when this webhook was last updated. Initial value is 0001-01-01T00:00:0Z.

get/audit-log-destinations/{auditLogDestinationId}
 
application/json

Update Audit Log Destination

Updates configuration for the audit log destination.

patch

Path Parameters

auditLogDestinationIdstring(uuid)required

ID of the Audit Log Destination.

Body

application/json

The request schema to modify an audit log destination.

namestring

The name of the audit log destination.

Example:My Destination

endpointstring

The endpoint that will receive audit log messages.

Example:https://example.com/audit-logs

authorizationstring

The value to include in the Authorization header when sending audit logs to the webhook.

Example:Bearer sometoken

log_formatstring

The output format of each log messages.

Allowed values:cefjsoncps

Default:cef

skip_ssl_verificationboolean

Indicates if the SSL certificate verification of the host endpoint should be skipped when delivering payloads.
We strongly recommend not setting this to ‘true’ as you are subject to man-in-the-middle and other attacks.
This option should be considered only for self-signed SSL certificates used in a non-production environment.

Default:false

Example:false

Response

application/json

Audit log destination response

AuditLogDestination

Audit Log Destination Schema

idstring(uuid)

The unique ID of the audit log destination.

namestring

The name of the audit log destination.

endpointstring

The endpoint that will receive audit log messages.

Example:https://example.com/audit-logs

log_formatstring

The output format of each log messages.

Allowed values:cefjsoncps

Default:cef

skip_ssl_verificationboolean

Indicates if the SSL certificate verification of the host endpoint should be skipped when delivering payloads.

Default:false

Example:false

created_atstring(date-time)read-only

Timestamp when this webhook was created.

updated_atstring(date-time)read-only

Timestamp when this webhook was last updated. Initial value is 0001-01-01T00:00:0Z.

patch/audit-log-destinations/{auditLogDestinationId}

Body

{ "endpoint": "https://example.com/audit-log-json", "log_format": "json", "skip_ssl_verification": false }
 
application/json

Delete Audit Log Destination

Deletes configuration for the audit log destination.

delete

Path Parameters

auditLogDestinationIdstring(uuid)required

ID of the Audit Log Destination.

Response

No Content

delete/audit-log-destinations/{auditLogDestinationId}
 

Get Audit Log Webhook Status

Returns status of the audit log webhook.

get

Response

application/json

Get response for audit logs webhook status

webhook_statusstring

Current status of a webhook. active indicates the webhook is sending or ready to send requests.
inactive indicates the webhook has been turned off due to failed attempts.

Allowed values:activeinactive

Example:active

webhook_enabledboolean

Configured status of a webhook. enabled indicates the client will accept requests.
disabled indicates the client will not accept requests.

Example:true

last_attempt_atstring(date-time)

The last time a request was made to the webhook, regardless of outcome.

Example:2023-03-21T09:29:14.52Z

last_response_codeinteger

The last response code received from the webhook.

Example:401

last_response_messagestring

The last message received from the webhook. Useful for debugging.

Example:Unauthenticated

get/audit-log-webhook/status
 
application/json