Dovkie
Sign in
Back to monitors

linear

Linear API

GraphQL
GraphQL SDL
https://raw.githubusercontent.com/linear/linear/master/packages/sdk/src/schema.graphql
Additive AI classification

Add AiConversationUserState and NullableInitiativeUpdateFilter types

The Linear GraphQL schema adds two new types: AiConversationUserState (tracking per-user read status in AI conversations) and NullableInitiativeUpdateFilter (for filtering initiative updates in comment queries), plus a new userState field on AiConversation and initiativeUpdate filter fields on comment filters. All additions are purely optional new fields and types that cannot break existing integrations.

Alert history

  • Additive

    Add AiConversationUserState and NullableInitiativeUpdateFilter types

    The Linear GraphQL schema adds two new types: AiConversationUserState (tracking per-user read status in AI conversations) and NullableInitiativeUpdateFilter (for filtering initiative updates in comment queries), plus a new userState field on AiConversation and initiativeUpdate filter fields on comment filters. All additions are purely optional new fields and types that cannot break existing integrations.

  • Additive

    Linear GraphQL API additions: agent diffs, content revisions, initiative filters

    Added support for coding agent workspace diffs (workspaceDiff, workspaceDiffFiles), document content revisions (DocumentContentRevision type), initiative filter suggestions via initiativeFilterSuggestion query, AI conversation acknowledgements (AiConversationAckPart), pull request commit signature verification data, and new workflow trigger types and conversation sources. All changes are backwards-compatible additive extensions to the schema.

  • Additive

    Add initiative label management API

    Adds new GraphQL mutations and queries for managing initiative labels: initiativeLabelCreate, initiativeLabelUpdate, initiativeLabelDelete, initiativeLabelRestore, and initiativeLabelRetire mutations; initiativeLabel and initiativeLabels queries; plus new supporting types InitiativeLabelCreateInput, InitiativeLabelUpdateInput, InitiativeLabelPayload. Also adds children and initiatives fields to the InitiativeLabel type, an optional project field to AiConversation, a new InitiativeLeadTeamUpdatePayload type, and a new enum value agentConversationMention in OtherNotificationType.

  • Additive

    Add agent skill inheritance, initiative visibility, and GraphQL filters

    Multiple new optional fields and types have been added to the Linear GraphQL schema: inheritedFrom field on AgentSkill, visibility field on Initiative, new InitiativeVisibility enum, new filtering options for release notes and pipelines, and workspace settings fields for initiative display. All changes are backward compatible and purely additive — existing queries will continue to work unchanged.

  • Additive

    Add AI conversation document ref, ReadFile tool, initiative features

    Multiple additive schema expansions: the AiConversation type gains an optional document field; new AiConversationReadFileToolCall and related types enable file-reading AI tool calls; AiFavoritesPayload and AiFavoritesInput support favoriting initiative labels; InitiativeLeadTeamChangeImpact type and initiativeLeadTeamUpdate mutation enable lead team management with impact preview; IntegrationSettingsInput and IntercomIntegrationSettingsInput add workflow definition and automatic conversation intake settings; Team gains initiativesEnabled flag; ViewPreferences and related types add initiative label support and team review visibility; and numerous documentation updates reframe "automations" as "loops." All changes are backward-compatible additions.

  • Additive

    Add AgentSkill type and related mutations for AI agent skills

    The Linear GraphQL schema adds a new AgentSkill type with associated input types (AgentSkillCreateInput, AgentSkillUpdateInput), connection types, and filtering (AgentSkillFilter), plus new query fields agentSkill and agentSkills to retrieve skills. This is purely additive: existing integrations are unaffected, and teams using the Linear Agent can now save and manage reusable skills. Additionally, several optional fields are added to existing types (reasonCode on AgentActivity, codingHarnessModelLabel on AgentSession, and elicitation support in AiConversation), along with documentation improvements and a new TeamVisibilityComparator filter input.

  • Breaking

    TeamVisibility enum value 'protected' removed, renamed to 'restricted'

    The protected enum value in TeamVisibility has been removed and replaced with restricted. Any client code filtering, comparing, or serializing TeamVisibility.protected will break. Additionally, the Team.protected: Boolean! field has been removed; Team.restrictedBy and Team.restrictedById are its replacements (alongside the existing protectedBy). Several additive changes are also included: new DocumentContentHistoryCheckpointMode enum, DocumentContentHistoryCheckpointType type, DocumentContentHistoryTimelinePayload type, the documentContentHistoryTimeline query, a new documentContentId field on DocumentContentHistoryType, and autoArchivedAt on the release type.

  • Additive

    Add coding session and release note tools to AI conversation API

    The Linear GraphQL schema adds three new tool call types for AI conversations (ListCodingSessionsToolCall, PromptCodingSessionToolCall, StartCodingSessionToolCall) and a ReleaseNote type to support AI-driven coding sessions. New fields are added to support issue sharing (issueShare and issueUnshare mutations), release filtering by release notes, initiative identifiers, and workspace settings for PR tour generation. These are all additive changes that extend functionality without breaking existing queries.

  • Additive

    Add OAuth application management mutations and fields

    The GraphQL schema adds OAuth application lifecycle management through new mutations (oauthApplicationCreate, oauthApplicationArchive, oauthApplicationRotateSecret, oauthApplicationRotateWebhookSecret, oauthApplicationUpdate) and new query fields (oauthApplication, oauthApplications) marked [ALPHA]. Also adds three new internal issue filter fields (hasActiveAgentSessions, hasDismissedAgentSessions, hasMergedAgentPullRequests), optional links field to release mutations/inputs, and a sort parameter to the users query. One nullable field change: IssueRelation.creator changed from required User! to nullable User.

  • Additive

    Add GitHub integration details and new schema fields

    The Linear GraphQL API adds several new optional fields and types across multiple entities: GitHubIntegrationConnectDetails type (exposing lostRepositoryNames), new fields for IntegrationPayload variants, Organization (cell), AuthUser (oauthClientId), CustomerNeed (content), Favorite (for release notes and pipeline tabs), UsageAlert and UsageAlertNotification types, TeamVisibility enum, and workflow-related fields. It also removes [Internal] markers from existing Comment and CommentCreateInput fields to surface them as public API, and adds new UserFlagType enum values. These changes are backwards compatible—all new fields are optional or additive.