AgentActivity
All agent activities.
Table-Specific Information
SELECT
The driver 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 driver.| Column | Supported Operators |
| id | =, !=, IN, NOT IN |
| createdAt | =, !=, IN, NOT IN, <, <=, >, >= |
| updatedAt | =, !=, IN, NOT IN, <, <=, >, >= |
| sourceCommentId | =, !=, IN, NOT IN, IS, IS NOT |
For example, the following queries are processed server-side:
SELECT * FROM AgentActivity LIMIT 1
SELECT * FROM AgentActivity WHERE createdAt = '2026-01-01T00:00:00Z' LIMIT 1
INSERT
To insert an AgentActivity record:INSERT INTO AgentActivity (agentSessionId, ephemeral) VALUES ('01bf10d3-8bfb-455c-b0db-769393ecf98b', false)
Columns
| Name | Type | ReadOnly | Description |
| id [KEY] | String | False |
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. |
| agentSessionId | String | False |
The agent session this activity belongs to. |
| sourceCommentId | String | True |
The source comment this activity is linked to. Null if the activity was not triggered by a comment. |
| userId | String | True |
The user who created this agent activity. |
| sourceMetadata | String | True |
Metadata about the external source that created this agent activity. |
| executionSkippedReason | String | True |
[Internal] The reason this activity was persisted without being sent to the agent runtime. |
| signal | String | False |
An optional modifier that provides additional instructions on how the activity should be interpreted. |
| ephemeral | Bool | False |
Whether the activity is ephemeral, and should disappear after the next agent activity. |
| contextualMetadata | String | False |
[Internal] Metadata about user-provided contextual information for this agent activity. |
| queued | Bool | True |
[Internal] Whether this activity is queued for later processing. Queued activities are not sent to the agent until the session reaches a terminal state. |
| sentAt | Datetime | True |
[Internal] The time at which the prompt actually entered the conversation. Only set when the prompt did not enter the conversation immediately (i.e., it was queued and later dequeued). Null for prompts that were sent directly and for non-prompt activities. |
| signalMetadata | String | False |
Metadata about this agent activity's signal. |
| content | String | False |
The content payload of the agent activity. This object is not strictly typed. See https://linear.app/developers/agent-interaction#activity-content-payload for typing details. Used only when creating or updating a record; reads return NULL. |