Creates a query.
Request
Query parameters
None.
Request
Request body properties (required)
| Property | Required | Type | Description |
|---|---|---|---|
| filters | Yes | object |
Defines the filter criteria used to select audit records. |
| filters.field | Yes | string |
Audit field to filter on. |
| filters.operator | Yes | string |
Comparison operator used to evaluate the field
value (for example, |
| filters.value | Yes | string | Value to compare against the specified audit field. |
| limit | No | integer |
Maximum number of audit records to return. |
Response
Response examples
{
"queryId": "a1b2c3d4-5678-90ef-gh12-ijklmnopqrst",
"status": "Queued",
"createdAt": "2026-03-24T18:42:15Z",
"createdBy": "user@example.com"
}{
"status": 400,
"type": "BadRequest",
"message": "The request body is invalid.",
"detail": {
"field": "filters.field",
"issue": "This field is required."
}
}{
"status": 401,
"type": "Unauthorized",
"message": "Authentication credentials are missing or invalid.",
"detail": {
"authorization": "Bearer token is missing or expired."
}
}{
"status": 403,
"type": "Forbidden",
"message": "You do not have permission to access this resource.",
"detail": {
"permission": "audit.query.read",
"reason": "Required permission is missing for the current user."
}
}{
"status": 500,
"type": "InternalServerError",
"message": "An unexpected error occurred while processing the request.",
"detail": {
"service": "audit-query-service",
"errorId": "f3a9c2e4-8b21-4d9a-a7c1-9f6c2b1d4e90"
}
}