Struct AgentSession 

pub struct AgentSession {

    pub id: Option<String>,
    pub created_at: Option<DateTime<Utc>>,
    pub updated_at: Option<DateTime<Utc>>,
    pub archived_at: Option<DateTime<Utc>>,
    pub creator: Option<Box<User>>,
    pub app_user: Option<Box<User>>,
    pub comment: Option<Box<Comment>>,
    pub source_comment: Option<Box<Comment>>,
    pub issue: Option<Box<Issue>>,
    pub slug_id: Option<String>,
    pub status: Option<AgentSessionStatus>,
    pub started_at: Option<DateTime<Utc>>,
    pub ended_at: Option<DateTime<Utc>>,
    pub dismissed_at: Option<DateTime<Utc>>,
    pub dismissed_by: Option<Box<User>>,
    pub activities: Option<AgentActivityConnection>,
    pub external_link: Option<String>,
    pub summary: Option<String>,
    pub source_metadata: Option<Value>,
    pub plan: Option<Value>,
    pub context: Option<Value>,
    pub type: Option<AgentSessionType>,
    pub url: Option<String>,
    pub pull_requests: Option<AgentSessionToPullRequestConnection>,
    pub external_links: Option<Vec<AgentSessionExternalLink>>,
    pub external_urls: Option<Value>,
}

A session representing an AI coding agent’s work on an issue or conversation. Agent sessions track the lifecycle of an agent’s engagement, from creation through active work to completion or dismissal. Each session is associated with an agent user (the bot), optionally a human creator, an issue, and a comment thread where the agent posts updates. Sessions contain activities that record the agent’s observable steps and can be linked to pull requests created during the work.

Fields

id: Option<String>

The unique identifier of the entity.

created_at: Option<DateTime<Utc>>

The time at which the entity was created.

updated_at: Option<DateTime<Utc>>

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.

archived_at: Option<DateTime<Utc>>

The time at which the entity was archived. Null if the entity has not been archived.

creator: Option<Box<User>>

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.

app_user: Option<Box<User>>

The agent user that is associated with this agent session.

comment: Option<Box<Comment>>

The comment this agent session is associated with.

source_comment: Option<Box<Comment>>

The comment that this agent session was spawned from, if from a different thread.

issue: Option<Box<Issue>>

The issue this agent session is associated with.

slug_id: Option<String>

The agent session’s unique URL slug.

status: Option<AgentSessionStatus>

The current status of the agent session, such as pending, active, awaiting input, complete, error, or stale.

started_at: Option<DateTime<Utc>>

The time the agent session transitioned to active status and began work. Null if the session has not yet started.

ended_at: Option<DateTime<Utc>>

The time the agent session completed. Null if the session is still in progress or was dismissed before completion.

dismissed_at: Option<DateTime<Utc>>

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.

dismissed_by: Option<Box<User>>

The user who dismissed the agent session. Automatically set when dismissedAt is updated. Null if the session has not been dismissed.

activities: Option<AgentActivityConnection>

Activities associated with this agent session.

external_link: Option<String>

The URL of an external agent-hosted page associated with this session.

summary: Option<String>

A human-readable summary of the work performed in this session. Null if no summary has been generated yet.

source_metadata: Option<Value>

Metadata about the external source that created this agent session.

plan: Option<Value>

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: Option<Value>

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.

type: Option<AgentSessionType>

DEPRECATED The type of the agent session.

url: Option<String>

The URL to the agent session page in the Linear app. Null for direct chat sessions without an associated issue.

pull_requests: Option<AgentSessionToPullRequestConnection>

Internal Pull requests associated with this agent session.

external_links: Option<Vec<AgentSessionExternalLink>>

External links associated with this session.

external_urls: Option<Value>

URLs of external resources associated with this session.

Trait Implementations

impl Clone for AgentSession

fn clone(&self) -> AgentSession

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentSession

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AgentSession

fn default() -> AgentSession

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentSession

where AgentSession: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl GraphQLFields for AgentSession

type FullType = AgentSession

The full generated type this implementation validates against.

fn selection() -> String

Return the GraphQL field selection string for this type.

impl Serialize for AgentSession

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.