AI logs record every interaction with Luzmo's AI features (Luzmo IQ, AI chart and dashboard generation, AI formulas, AI summaries, ...), whether they were triggered in the Luzmo application, in an embedded component, through the Core API or through the Luzmo MCP server. Each AI log represents one turn: the prompt, the response, the agent that handled it, the datasets and assets involved, the latency and the outcome. Turns of the same conversation share a conversation_id .
AI logs are read-only: they cannot be created or updated through the API, and they cannot be included in other resources.
Things to keep in mind:
Only organization owners and admins can retrieve AI logs.
AI logs must be enabled for your organization's plan, otherwise the request returns an error.
Logs are kept for a 30-day retention period. Only logs created within the last 30 days are returned. A created_at.gte filter that is older than the retention window is replaced by the start of the window.
Results are always scoped to your organization, and include the AI logs of all users in it.
Only the filters, attributes and order fields listed below are supported. Unknown properties (including include ) result in a validation error.
Results are ordered by created_at (newest first) by default.
Use Detail AILog to retrieve a single AI log together with the context that was used to answer it, and Conversation AILog to retrieve all turns of a conversation.
npm install @luzmo/nodejs-sdk{
"count": 1,
"rows": [
{
"id": "5d1c2b3a-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"organization_id": "4a2b6c1d-8e3f-4a5b-9c7d-2e1f0a3b5c6d",
"suborganization_id": "acme-corp",
"user_id": "fde42af0-57f8-40e3-880c-3464d9a525ce",
"authorization_id": "8c9d0e1f-2a3b-4c5d-8e6f-7a8b9c0d1e2f",
"authorization_type": "embed",
"authorization_name": "Customer portal",
"agent": "analyst",
"routed_to": [],
"auto_routed": false,
"task": "",
"conversation_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
"message_id": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f",
"parent_message_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"prompt": "What was our revenue per region last quarter?",
"response_text": "Revenue last quarter was highest in Europe (1.2M), followed by North America (0.9M) and APAC (0.4M).",
"response_summary": "chart",
"result_types": [
"text",
"chart"
],
"result_count": 1,
"dataset_ids": [
"24aa02fe-d54d-4217-bd9d-dcdba45c83b3"
],
"asset_ids": [
"6e7f8a9b-0c1d-4e2f-8a3b-4c5d6e7f8a9b"
],
"latency_ms": 6420,
"success": true,
"out_of_scope": false,
"cancelled": false,
"failure_reason": null,
"trace_id": "6f1d2c3b4a5e4f6a8b7c9d0e1f2a3b4c",
"request_id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
"locale_id": "en",
"origin_domain": "app.example.com",
"started_at": "2026-10-12T09:41:21.104Z",
"ended_at": "2026-10-12T09:41:27.524Z",
"created_at": "2026-10-12T09:41:27.530Z",
"source": "embedded",
"feature": "chat_component",
"feedback_rating": 1,
"flagged": false,
"user": {
"id": "fde42af0-57f8-40e3-880c-3464d9a525ce",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"thumbnails": []
}
}
]
}