---
title: "Log"
description: "The `Log` entity."
section: "Reference"
group: "Types"
order: 144
---

## Definition

```ts
interface Log {
  id: string;
  workspaceId: string | null;
  subjectId: string | null;
  level: "error" | "debug" | "info" | "warn";
  source: string;
  message: string;
  data: unknown;
  createdAt: string;
}
```

## Fields

| Field         | Type                                     | Notes                                                                                     |
| ------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------- |
| `id`          | `string`                                 | `readonly` `required`                                                                     |
| `workspaceId` | `string \| null`                         | `required` — Workspace this log is scoped to; null for system logs (cron, worker boot).   |
| `subjectId`   | `string \| null`                         | `required` — Prefixed ID of the entity the log is about; type is derived from the prefix. |
| `level`       | `"error" \| "debug" \| "info" \| "warn"` | `required` — Severity level (debug, info, warn, error).                                   |
| `source`      | `string`                                 | `required` — Origin of the log (api, runner, email, ...).                                 |
| `message`     | `string`                                 | `required` — Primary human-readable log message.                                          |
| `data`        | `unknown`                                | `required` — Structured context attached to the log entry, if any.                        |
| `createdAt`   | `string`                                 | `readonly` `required` — ISO-8601 timestamp when the log line was recorded.                |