AgentSession
All agent sessions.
Table-Specific Information
SELECT
Retrieve Linear AgentSession records:SELECT * FROM AgentSession LIMIT 1
INSERT
To insert an AgentSession record:INSERT INTO AgentSession (appUserId, context) VALUES ('cfa5f5f6-bcd8-4a1e-9844-5186f9af10e3', 'Code review assistant context.')
UPDATE
To update an AgentSession record:UPDATE AgentSession SET dismissedAt = '2026-06-01T00:00:00Z' WHERE id = '01bf10d3-8bfb-455c-b0db-769393ecf98b'
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. |
| creatorId | String | True |
The human user responsible for the agent session. Null if the session was initiated via automation or by an agent user, with no responsible human user. |
| appUserId | String | False |
The agent user that is associated with this agent session. |
| commentId | String | True |
The comment this agent session is associated with. |
| sourceCommentId | String | True |
The comment that this agent session was spawned from, if from a different thread. |
| issueId | String | False |
The issue this agent session is associated with. |
| slugId | String | True |
The agent session's unique URL slug. |
| status | String | True |
The current status of the agent session, such as pending, active, awaiting input, complete, error, or stale. |
| startedAt | Datetime | True |
The time the agent session transitioned to active status and began work. Null if the session has not yet started. |
| endedAt | Datetime | True |
The time the agent session completed. Null if the session is still in progress or was dismissed before completion. |
| dismissedAt | Datetime | False |
The time a user dismissed this agent session. When dismissed, the agent is removed as delegate from the associated issue. Null if the session has not been dismissed. |
| dismissedById | String | True |
The user who dismissed the agent session. Automatically set when dismissedAt is updated. Null if the session has not been dismissed. |
| summary | String | False |
The session title, generated automatically or set by the owning OAuth application. Null if no title is set. |
| sourceMetadata | String | True |
Metadata about the external source that created this agent session. |
| modelSelection | String | True |
[Internal] How Adaptive selected the model route used by this coding session. |
| plan | String | False |
A dynamically updated plan describing the agent's execution strategy, including steps to be taken and their current status. Updated as the agent progresses through its work. Null if no plan has been set. |
| context | String | False |
The entity contexts this session is related to, such as issues or projects referenced in direct chat sessions. Used to provide contextual awareness to the agent. |
| url | String | True |
The URL to the agent session page in the Linear app. Null when no issue is associated. |
| codingHarnessModelLabel | String | True |
[Internal] Compact display label for the coding harness model used by this session, derived from the latest associated sandbox. |