Notification
The authenticated user's notifications.
Table-Specific Information
SELECT
The component uses the Linear API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the component.| Column | Supported Operators |
| id | =, !=, IN, NOT IN |
| createdAt | =, !=, IN, NOT IN, <, <=, >, >= |
| updatedAt | =, !=, IN, NOT IN, <, <=, >, >= |
| archivedAt | =, !=, IN, NOT IN, <, <=, >, >= |
| type | =, !=, IN, NOT IN, LIKE, CONTAINS |
For example, the following queries are processed server-side:
SELECT * FROM Notification LIMIT 1
SELECT * FROM Notification WHERE createdAt = '2026-01-01T00:00:00Z' LIMIT 1
UPDATE
To update a Notification record:UPDATE Notification SET readAt = '2026-01-01T00:00:00Z' WHERE id = 'feb9ca65-ee57-4edd-818a-76b43a0e60f4'
Columns
| Name | Type | ReadOnly | Description |
| id [KEY] | String | True |
The unique identifier of the entity. |
| createdAt | Datetime | True |
The time at which the entity was created. |
| updatedAt | Datetime | True |
The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't been updated after creation. |
| archivedAt | Datetime | True |
The time at which the entity was archived. Null if the entity has not been archived. |
| type | String | True |
Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated. |
| actorId | String | True |
The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event. |
| externalUserActorId | String | True |
The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member. |
| userId | String | True |
The recipient user of this notification. |
| readAt | Datetime | False |
The time at which the user marked the notification as read. Null if the notification is unread. |
| emailedAt | Datetime | True |
The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent. |
| snoozedUntilAt | Datetime | False |
The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed. |
| unsnoozedAt | Datetime | True |
The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed. |
| category | String | True |
The category of the notification. |
| url | String | True |
[Internal] URL to the target of the notification. |
| inboxUrl | String | True |
[Internal] Inbox URL for the notification. |
| title | String | True |
[Internal] Notification title. |
| subtitle | String | True |
[Internal] Notification subtitle. |
| isLinearActor | Bool | True |
[Internal] If notification actor was Linear. |
| actorAvatarUrl | String | True |
[Internal] Notification avatar URL. |
| actorInitials | String | True |
[Internal] Notification actor initials if avatar is not available. |
| actorAvatarColor | String | True |
[Internal] Notification actor initials if avatar is not available. |
| actorInactive | Bool | True |
[Internal] Whether the notification's user actor is deactivated in the workspace. |
| issueStatusType | String | True |
[Internal] Issue's status type for issue notifications. |
| projectUpdateHealth | String | True |
[Internal] Project update health for new updates. |
| initiativeUpdateHealth | String | True |
[Internal] Initiative update health for new updates. |
| groupingKey | String | True |
[Internal] Notifications with the same grouping key will be grouped together in the UI. |
| groupingPriority | Double | True |
[Internal] Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`. |