UsageAlert
The workspace's usage-based billing alerts, such as a low or exhausted usage credit balance. Alerts for expired promotional credits are archived and excluded unless archived resources are requested. Use resolvedAt to tell an open alert from one whose condition has since cleared.
View-Specific Information
SELECT
Retrieve Linear UsageAlert records:SELECT * FROM UsageAlert WHERE createdAt = '2026-01-01T00:00:00Z'
Columns
| Name | Type | Description |
| id [KEY] | String | The unique identifier of the entity. |
| createdAt | Datetime | The time at which the entity was created. |
| updatedAt | Datetime | 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 | The time at which the entity was archived. Null if the entity has not been archived. |
| type | String | The kind of usage alert that was triggered. |
| metadata | String | Type-specific snapshot captured when the alert was triggered, keyed by the alert type — for example the credit balance and threshold for a lowBalance alert. A resolution entry is added once new usage credits have landed and cleared the alert's condition. |
| resolvedAt | Datetime | The time when the usage alert was resolved or archived. Null if the alert is still active. |