List audit log entries

GET 
/audit

Returns a paginated list of audit log entries, newest first.

Request

Query Parameters

limit integer

Possible values: >= 1 and <= 100

Default value: 20

Maximum number of entries to return.

offset integer

Default value: 0

Number of entries to skip.

Responses

200

List of audit entries.

application/json

Schema

Schema

total_items integerrequired

Total number of audit entries.

items

object[]

required

The audit entries for this page.

Array [

id uuidrequired

Unique identifier for the audit entry.

timestamp date-timerequired

When the request was processed.

user stringrequired

Authenticated user (JWT subject).

roles string[]required

Roles from the JWT token.

method stringrequired

HTTP method.

path stringrequired

Request URL path.

operation_id string

OpenAPI operation ID.

source_ip stringrequired

Client IP address.

response_code integerrequired

HTTP response status code.

duration_ms int64required

Request duration in milliseconds.

]

Example (from schema)

{
  "total_items": 150,
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2026-02-21T10:30:00Z",
      "user": "ops@example.com",
      "roles": [
        "admin"
      ],
      "method": "GET",
      "path": "/node/hostname",
      "operation_id": "GetNodeHostname",
      "source_ip": "192.168.1.100",
      "response_code": 200,
      "duration_ms": 42
    }
  ]
}

400

Invalid request parameters.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

401

Unauthorized - API key required.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

403

Forbidden - Insufficient permissions.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

500

Internal server error.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

Loading...