Search AILog

LLM-friendly URL
POST
https://api.luzmo.com/0.1.0/ailog
API call form
Examples

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.

Request parametersResponse schema
count NUMBER

The number of records returned

rows ARRAY[OBJECT]
id UUID
organization_id UUID
suborganization_id STRING
user_id UUID
user OBJECT
authorization_id UUID
authorization_type STRING
authorization_name STRING
source STRING
feature STRING
agent STRING
routed_to ARRAY[STRING]
auto_routed BOOLEAN
task STRING
conversation_id UUID
message_id UUID
parent_message_id UUID
prompt STRING
response_text STRING
response_summary STRING
result_types ARRAY[STRING]
result_count NUMBER
dataset_ids ARRAY[STRING]
asset_ids ARRAY[STRING]
latency_ms NUMBER
success BOOLEAN
out_of_scope BOOLEAN
cancelled BOOLEAN
failure_reason STRING
feedback_rating NUMBER
flagged BOOLEAN
trace_id STRING
request_id STRING
locale_id STRING
origin_domain STRING
started_at DATETIME
ended_at DATETIME
created_at DATETIME
Can be executed by:
Organization Owner
Organization Admin
Can be associated to:
Did this page help you?
Yes No
Language
Shell
Node
Java
.NET
Python
PHP
Install
npm install @luzmo/nodejs-sdk
Example Response
200
400
500
{
  "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": []
      }
    }
  ]
}