# Get paginated list of query logs with filtering

Retrieves a paginated list of query log records with optional filtering.
Key Features: - Cursor-based pagination with pageSize and cursor - Multiple filter options to narrow down results - Operation tracking - see all API operations performed on content - Audit trail - complete history of who did what and when
Common Use Cases: - Track content operations by a specific user - Monitor operations on a particular dataspace - Audit trail for compliance and debugging - Performance analysis of API usage
Filter Examples: - Get all CREATE operations: ?operationType=CREATE - Get operations by user: ?userId=scd-dev00001 - Get operations in date range: ?dateFrom=2025-06-10T00:00:00Z&dateTo=2025-06-10T23:59:59Z - Get operations on specific content: ?contentId=98765432-1abc-def0-1234-56789abcdef0

Endpoint: GET /query-logs
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `pageSize` (integer)
    Number of items per page
    Example: 25

  - `cursor` (string)
    Cursor for pagination
    Example: "03456789-abcd-ef01-2345-6789abcdef12"

  - `operationType` (string)
    Filter by operation type
    Enum: "GET", "OPEN", "CREATE", "UPDATE", "ANALYZE", "GET_MANY", "OPEN_MANY", "CREATE_MANY", "UPDATE_MANY", "ANALYZE_MANY", "DELETE"

  - `userId` (string)
    Filter by user ID
    Example: "scd-dev00001"

  - `contentId` (string,null)
    Filter by content ID
    Example: "98765432-1abc-def0-1234-56789abcdef0"

  - `dataspaceId` (string)
    Filter by dataspace ID
    Example: "sds-dev00001"

  - `operationSource` (string)
    Filter by operation source
    Enum: "explicit", "implicit"

  - `parentId` (string,null)
    Filter by parent query log ID
    Example: "02345678-9abc-def0-1234-56789abcdef1"

  - `dateFrom` (string)
    Filter by date range start
    Example: "2025-06-10T00:00:00Z"

  - `dateTo` (string)
    Filter by date range end
    Example: "2025-06-10T23:59:59Z"

## Response 200 fields (application/json):

  - `queryLogs` (array, required)
    List of query log records
    Example: [{"id":"01234567-89ab-cdef-0123-456789abcdef","operationType":"CREATE","userId":"scd-dev00001","contentId":"98765432-1abc-def0-1234-56789abcdef0","dataspaceId":"sds-dev00001","operationSource":"explicit","query":{"method":"POST","path":"/api/content/sds-dev00001","params":{"dataspaceId":"sds-dev00001"},"query":{},"body":{"categoryId":"12345678-90ab-cdef-1234-567890abcdef","metadata":{"permitType":"sidewalk","applicantName":"John Doe"},"fileFormat":"application/pdf","fileName":"sidewalk_permit_001.pdf"},"headers":{"content-type":"multipart/form-data","user-agent":"axios/1.6.0"},"timestamp":"2025-06-10T20:28:42.113Z"},"parentId":null,"queriedAt":"2025-06-10T20:28:42.113Z"},{"id":"02345678-9abc-def0-1234-56789abcdef1","operationType":"GET_MANY","userId":"scd-dev00001","contentId":null,"dataspaceId":"sds-dev00001","operationSource":"explicit","query":{"method":"POST","path":"/api/content/sds-dev00001/fetch","params":{"dataspaceId":"sds-dev00001"},"query":{"pageSize":50},"body":{"filters":{}},"headers":{"content-type":"application/json","user-agent":"axios/1.6.0"},"timestamp":"2025-06-10T20:28:42.428Z"},"parentId":null,"queriedAt":"2025-06-10T20:28:42.428Z"}]

  - `queryLogs.id` (string, required)
    Unique query log ID
    Example: "01234567-89ab-cdef-0123-456789abcdef"

  - `queryLogs.operationType` (string, required)
    Type of operation performed
    Enum: "GET", "OPEN", "CREATE", "UPDATE", "ANALYZE", "GET_MANY", "OPEN_MANY", "CREATE_MANY", "UPDATE_MANY", "ANALYZE_MANY", "DELETE"

  - `queryLogs.operationScope` (string)
    Scope of the operation - content or dataspace level
    Enum: "content", "dataspace"

  - `queryLogs.userId` (string, required)
    ID of the user who performed the query
    Example: "scd-dev00001"

  - `queryLogs.userEmail` (string)
    Email of the user who performed the query
    Example: "user@syncdocs.com"

  - `queryLogs.contentName` (string)
    Name of the content that was operated on
    Example: "Sidewalk Permit"

  - `queryLogs.contentId` (string,null, required)
    ID of the content operated on, null for LIST operations
    Example: "98765432-1abc-def0-1234-56789abcdef0"

  - `queryLogs.dataspaceId` (string, required)
    Short dataspace ID with sds- prefix
    Example: "sds-dev00001"

  - `queryLogs.operationSource` (string, required)
    Whether the operation was explicit or implicit
    Enum: "explicit", "implicit"

  - `queryLogs.query` (object, required)
    JSONB format information to reconstruct the API call
    Example: {"method":"POST","path":"/api/content/sds-dev00001","params":{"dataspaceId":"sds-dev00001"},"query":{},"body":{"categoryId":"12345678-90ab-cdef-1234-567890abcdef","metadata":{"permitType":"sidewalk","applicantName":"John Doe"},"fileFormat":"application/pdf","fileName":"sidewalk_permit_001.pdf"},"headers":{"content-type":"multipart/form-data","user-agent":"axios/1.6.0"},"timestamp":"2025-06-10T20:28:42.113Z"}

  - `queryLogs.parentId` (string,null, required)
    ID of the parent query log, used for LIST/Inferred logging type
    Example: "02345678-9abc-def0-1234-56789abcdef1"

  - `queryLogs.queriedAt` (string, required)
    Timestamp of when the query was performed
    Example: "2025-06-10T20:28:42.113Z"

  - `nextCursor` (string)
    Cursor for next page
    Example: "03456789-abcd-ef01-2345-6789abcdef12"

  - `totalCount` (integer, required)
    Total number of records
    Example: 54

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Invalid query parameters"

  - `details` (object)
    Example: {"pageSize":"Must be between 1 and 100","dateFrom":"Must be a valid ISO datetime string"}

## Response 401 fields (application/json):

  - `error` (string)
    Example: "Unauthorized - No credentials provided"

## Response 500 fields (application/json):

  - `error` (string)
    Example: "Internal server error"