Skip to content

Audit Event Publishing Failed

URI: https://docs.ankatech.co/errors/kafka-publish-failure
HTTP Status: 503 Service Unavailable

When you see this

The service could not publish the required audit event to the event stream, so the operation was not completed. Operations that must be auditable fail closed when the audit event cannot be recorded.

Common Causes

  • The event-streaming backbone is temporarily unavailable.
  • A transient failure publishing the audit event.
  • Back-pressure or a timeout while writing to the audit topic.

Response Example

{
  "type": "https://docs.ankatech.co/errors/kafka-publish-failure",
  "title": "Audit Event Publishing Failed",
  "status": 503,
  "detail": "Failed to publish the audit event. The operation was not completed.",
  "instance": "/api/v3/admin/tenants/00000000-0000-0000-0000-000000000001/policies",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1730000000
}

Content-Type: application/problem+json — the response follows RFC 7807 Problem Details.

How to Resolve

  1. Retry the request after a short delay — audit publishing failures are usually transient.
  2. Honor the Retry-After header when present, otherwise apply exponential backoff.
  3. If the failure persists, contact support with the correlationId, as audit-critical operations remain blocked until publishing recovers.

For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.