Audit Logs

Create Audit Log Destination

Changed on

Creates a configuration for the audit log destination.

post/v2/audit-log-destinations

Request

  • Base URL: https://global.api.konghq.com
  • URL: https://global.api.konghq.com/v2/audit-log-destinations
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Request body

namestring required

The name of the audit log destination.

endpointstring required

The endpoint that will receive audit log messages.

authorizationstring required

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

log_format'cef' | 'json' | 'cps' required

The output format of each log messages.

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.

Example request

{
  "name": "My Destination",
  "endpoint": "https://example.com/audit-logs",
  "authorization": "Bearer sometoken"
}

Response

Audit log destination response

idstring uuid

The unique ID of the audit log destination.

namestring nullable

The name of the audit log destination.

endpointstring nullable

The endpoint that will receive audit log messages.

log_format'cef' | 'json' | 'cps'

The output format of each log messages.

skip_ssl_verificationboolean

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

created_atstring date-time

Timestamp when this webhook was created.

updated_atstring date-time

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

Example response

{
  "endpoint": "https://example.com/audit-logs"
}

Changes

  • f530bf400198Revision changes
    • warning

      added the new 400.00 enum value to the response property for the response status

    • warning

      added the new 403.00 enum value to the response property for the response status

  • 4a02153f2e60Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status