How do I install the Linear full reference skill?

Run npx skillmds@latest add tools-only/linear-full-reference-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Linear full reference skill do?

This is the full reference documentation for the Linear agent connector. It is listed under Coding & Dev Tools on SkillMD.

Is Linear full reference safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Linear full reference?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Linear full reference free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Linear full reference?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Linear full reference by tools-only

Name: Linear full reference
Author: tools-only

Linear full reference

This is the full reference documentation for the Linear agent connector.

Supported entities and actions

The Linear connector supports the following entities and actions.

Entity	Actions
Issues	List, Get, Create, Update, Search
Projects	List, Get, Search
Teams	List, Get, Search
Users	List, Get, Search
Comments	List, Get, Create, Update, Search

Issues

Issues List

Returns a paginated list of issues via GraphQL with pagination support

Python SDK

await linear.issues.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "issues",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`first`	`integer`	No	Number of items to return (max 250)
`after`	`string`	No	Cursor to start after (for pagination)

Records

Field Name	Type	Description
`id`	`string`
`title`	`string`
`description`	`string \| any`
`state`	`object \| any`
`priority`	`number \| any`
`assignee`	`object \| any`
`createdAt`	`string`
`updatedAt`	`string`

Field Name	Type	Description
`hasNextPage`	`boolean`
`endCursor`	`string \| null`

Issues Get

Get a single issue by ID via GraphQL

Python SDK

await linear.issues.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "issues",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Issue ID

Records

Field Name	Type	Description
`data`	`object`

Issues Create

Create a new issue via GraphQL mutation

Python SDK

await linear.issues.create(
    team_id="<str>",
    title="<str>",
    description="<str>",
    state_id="<str>",
    priority=0
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "issues",
    "action": "create",
    "params": {
        "teamId": "<str>",
        "title": "<str>",
        "description": "<str>",
        "stateId": "<str>",
        "priority": 0
    }
}'

Parameters

Parameter Name	Type	Required	Description
`teamId`	`string`	Yes	The ID of the team to create the issue in
`title`	`string`	Yes	The title of the issue
`description`	`string`	No	The description of the issue (supports markdown)
`stateId`	`string`	No	The ID of the workflow state for the issue
`priority`	`integer`	No	The priority of the issue (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low)

Records

Field Name	Type	Description
`data`	`object`

Issues Update

Update an existing issue via GraphQL mutation. All fields except id are optional for partial updates. To assign a user, provide assigneeId with the user's ID (get user IDs from the users list). Omit assigneeId to leave the current assignee unchanged.

Python SDK

await linear.issues.update(
    id="<str>",
    title="<str>",
    description="<str>",
    state_id="<str>",
    priority=0,
    assignee_id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "issues",
    "action": "update",
    "params": {
        "id": "<str>",
        "title": "<str>",
        "description": "<str>",
        "stateId": "<str>",
        "priority": 0,
        "assigneeId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	The ID of the issue to update
`title`	`string`	No	The new title of the issue
`description`	`string`	No	The new description of the issue (supports markdown)
`stateId`	`string`	No	The ID of the new workflow state for the issue
`priority`	`integer`	No	The new priority of the issue (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low)
`assigneeId`	`string`	No	The ID of the user to assign to this issue. Get user IDs from the users list.

Records

Field Name	Type	Description
`data`	`object`

Issues Search

Search and filter issues records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await linear.issues.search(
    query={"filter": {"eq": {"addedToCycleAt": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "issues",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"addedToCycleAt": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`addedToCycleAt`	`string`
`addedToProjectAt`	`string`
`addedToTeamAt`	`string`
`assignee`	`object`
`assigneeId`	`string`
`attachmentIds`	`array`
`attachments`	`object`
`branchName`	`string`
`canceledAt`	`string`
`completedAt`	`string`
`createdAt`	`string`
`creator`	`object`
`creatorId`	`string`
`customerTicketCount`	`number`
`cycle`	`object`
`cycleId`	`string`
`description`	`string`
`descriptionState`	`string`
`dueDate`	`string`
`estimate`	`number`
`id`	`string`
`identifier`	`string`
`integrationSourceType`	`string`
`labelIds`	`array`
`labels`	`object`
`milestoneId`	`string`
`number`	`number`
`parent`	`object`
`parentId`	`string`
`previousIdentifiers`	`array`
`priority`	`number`
`priorityLabel`	`string`
`prioritySortOrder`	`number`
`project`	`object`
`projectId`	`string`
`projectMilestone`	`object`
`reactionData`	`array`
`relationIds`	`array`
`relations`	`object`
`slaType`	`string`
`sortOrder`	`number`
`sourceCommentId`	`string`
`startedAt`	`string`
`state`	`object`
`stateId`	`string`
`subIssueSortOrder`	`number`
`subscriberIds`	`array`
`subscribers`	`object`
`team`	`object`
`teamId`	`string`
`title`	`string`
`updatedAt`	`string`
`url`	`string`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.addedToCycleAt`	`string`
`hits[].data.addedToProjectAt`	`string`
`hits[].data.addedToTeamAt`	`string`
`hits[].data.assignee`	`object`
`hits[].data.assigneeId`	`string`
`hits[].data.attachmentIds`	`array`
`hits[].data.attachments`	`object`
`hits[].data.branchName`	`string`
`hits[].data.canceledAt`	`string`
`hits[].data.completedAt`	`string`
`hits[].data.createdAt`	`string`
`hits[].data.creator`	`object`
`hits[].data.creatorId`	`string`
`hits[].data.customerTicketCount`	`number`
`hits[].data.cycle`	`object`
`hits[].data.cycleId`	`string`
`hits[].data.description`	`string`
`hits[].data.descriptionState`	`string`
`hits[].data.dueDate`	`string`
`hits[].data.estimate`	`number`
`hits[].data.id`	`string`
`hits[].data.identifier`	`string`
`hits[].data.integrationSourceType`	`string`
`hits[].data.labelIds`	`array`
`hits[].data.labels`	`object`
`hits[].data.milestoneId`	`string`
`hits[].data.number`	`number`
`hits[].data.parent`	`object`
`hits[].data.parentId`	`string`
`hits[].data.previousIdentifiers`	`array`
`hits[].data.priority`	`number`
`hits[].data.priorityLabel`	`string`
`hits[].data.prioritySortOrder`	`number`
`hits[].data.project`	`object`
`hits[].data.projectId`	`string`
`hits[].data.projectMilestone`	`object`
`hits[].data.reactionData`	`array`
`hits[].data.relationIds`	`array`
`hits[].data.relations`	`object`
`hits[].data.slaType`	`string`
`hits[].data.sortOrder`	`number`
`hits[].data.sourceCommentId`	`string`
`hits[].data.startedAt`	`string`
`hits[].data.state`	`object`
`hits[].data.stateId`	`string`
`hits[].data.subIssueSortOrder`	`number`
`hits[].data.subscriberIds`	`array`
`hits[].data.subscribers`	`object`
`hits[].data.team`	`object`
`hits[].data.teamId`	`string`
`hits[].data.title`	`string`
`hits[].data.updatedAt`	`string`
`hits[].data.url`	`string`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Projects

Projects List

Returns a paginated list of projects via GraphQL with pagination support

Python SDK

await linear.projects.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`first`	`integer`	No	Number of items to return (max 250)
`after`	`string`	No	Cursor to start after (for pagination)

Records

Field Name	Type	Description
`id`	`string`
`name`	`string`
`description`	`string \| any`
`state`	`string \| any`
`startDate`	`string \| any`
`targetDate`	`string \| any`
`lead`	`object \| any`
`createdAt`	`string`
`updatedAt`	`string`

Field Name	Type	Description
`hasNextPage`	`boolean`
`endCursor`	`string \| null`

Projects Get

Get a single project by ID via GraphQL

Python SDK

await linear.projects.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Project ID

Records

Field Name	Type	Description
`data`	`object`

Projects Search

Search and filter projects records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await linear.projects.search(
    query={"filter": {"eq": {"canceledAt": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "projects",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"canceledAt": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`canceledAt`	`string`
`color`	`string`
`completedAt`	`string`
`completedIssueCountHistory`	`array`
`completedScopeHistory`	`array`
`content`	`string`
`contentState`	`string`
`convertedFromIssue`	`object`
`convertedFromIssueId`	`string`
`createdAt`	`string`
`creator`	`object`
`creatorId`	`string`
`description`	`string`
`health`	`string`
`healthUpdatedAt`	`string`
`icon`	`string`
`id`	`string`
`inProgressScopeHistory`	`array`
`issueCountHistory`	`array`
`lead`	`object`
`leadId`	`string`
`name`	`string`
`priority`	`number`
`prioritySortOrder`	`number`
`progress`	`number`
`scope`	`number`
`scopeHistory`	`array`
`slugId`	`string`
`sortOrder`	`number`
`startDate`	`string`
`startedAt`	`string`
`status`	`object`
`statusId`	`string`
`targetDate`	`string`
`teamIds`	`array`
`teams`	`object`
`updateRemindersDay`	`string`
`updateRemindersHour`	`number`
`updatedAt`	`string`
`url`	`string`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.canceledAt`	`string`
`hits[].data.color`	`string`
`hits[].data.completedAt`	`string`
`hits[].data.completedIssueCountHistory`	`array`
`hits[].data.completedScopeHistory`	`array`
`hits[].data.content`	`string`
`hits[].data.contentState`	`string`
`hits[].data.convertedFromIssue`	`object`
`hits[].data.convertedFromIssueId`	`string`
`hits[].data.createdAt`	`string`
`hits[].data.creator`	`object`
`hits[].data.creatorId`	`string`
`hits[].data.description`	`string`
`hits[].data.health`	`string`
`hits[].data.healthUpdatedAt`	`string`
`hits[].data.icon`	`string`
`hits[].data.id`	`string`
`hits[].data.inProgressScopeHistory`	`array`
`hits[].data.issueCountHistory`	`array`
`hits[].data.lead`	`object`
`hits[].data.leadId`	`string`
`hits[].data.name`	`string`
`hits[].data.priority`	`number`
`hits[].data.prioritySortOrder`	`number`
`hits[].data.progress`	`number`
`hits[].data.scope`	`number`
`hits[].data.scopeHistory`	`array`
`hits[].data.slugId`	`string`
`hits[].data.sortOrder`	`number`
`hits[].data.startDate`	`string`
`hits[].data.startedAt`	`string`
`hits[].data.status`	`object`
`hits[].data.statusId`	`string`
`hits[].data.targetDate`	`string`
`hits[].data.teamIds`	`array`
`hits[].data.teams`	`object`
`hits[].data.updateRemindersDay`	`string`
`hits[].data.updateRemindersHour`	`number`
`hits[].data.updatedAt`	`string`
`hits[].data.url`	`string`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Teams

Teams List

Returns a list of teams via GraphQL with pagination support

Python SDK

await linear.teams.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "teams",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`first`	`integer`	No	Number of items to return (max 250)
`after`	`string`	No	Cursor to start after (for pagination)

Records

Field Name	Type	Description
`id`	`string`
`name`	`string`
`key`	`string`
`description`	`string \| any`
`timezone`	`string \| any`
`createdAt`	`string`
`updatedAt`	`string`

Field Name	Type	Description
`hasNextPage`	`boolean`
`endCursor`	`string \| null`

Teams Get

Get a single team by ID via GraphQL

Python SDK

await linear.teams.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "teams",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Team ID

Records

Field Name	Type	Description
`data`	`object`

Teams Search

Search and filter teams records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await linear.teams.search(
    query={"filter": {"eq": {"activeCycle": {}}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "teams",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"activeCycle": {}}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`activeCycle`	`object`
`activeCycleId`	`string`
`autoArchivePeriod`	`number`
`autoClosePeriod`	`number`
`autoCloseStateId`	`string`
`color`	`string`
`createdAt`	`string`
`cycleCalenderUrl`	`string`
`cycleCooldownTime`	`number`
`cycleDuration`	`number`
`cycleIssueAutoAssignCompleted`	`boolean`
`cycleIssueAutoAssignStarted`	`boolean`
`cycleLockToActive`	`boolean`
`cycleStartDay`	`number`
`cyclesEnabled`	`boolean`
`defaultIssueEstimate`	`number`
`defaultIssueState`	`object`
`defaultIssueStateId`	`string`
`groupIssueHistory`	`boolean`
`icon`	`string`
`id`	`string`
`inviteHash`	`string`
`issueCount`	`number`
`issueEstimationAllowZero`	`boolean`
`issueEstimationExtended`	`boolean`
`issueEstimationType`	`string`
`key`	`string`
`markedAsDuplicateWorkflowState`	`object`
`markedAsDuplicateWorkflowStateId`	`string`
`name`	`string`
`parentTeamId`	`string`
`private`	`boolean`
`requirePriorityToLeaveTriage`	`boolean`
`scimManaged`	`boolean`
`setIssueSortOrderOnStateChange`	`string`
`timezone`	`string`
`triageEnabled`	`boolean`
`triageIssueStateId`	`string`
`upcomingCycleCount`	`number`
`updatedAt`	`string`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.activeCycle`	`object`
`hits[].data.activeCycleId`	`string`
`hits[].data.autoArchivePeriod`	`number`
`hits[].data.autoClosePeriod`	`number`
`hits[].data.autoCloseStateId`	`string`
`hits[].data.color`	`string`
`hits[].data.createdAt`	`string`
`hits[].data.cycleCalenderUrl`	`string`
`hits[].data.cycleCooldownTime`	`number`
`hits[].data.cycleDuration`	`number`
`hits[].data.cycleIssueAutoAssignCompleted`	`boolean`
`hits[].data.cycleIssueAutoAssignStarted`	`boolean`
`hits[].data.cycleLockToActive`	`boolean`
`hits[].data.cycleStartDay`	`number`
`hits[].data.cyclesEnabled`	`boolean`
`hits[].data.defaultIssueEstimate`	`number`
`hits[].data.defaultIssueState`	`object`
`hits[].data.defaultIssueStateId`	`string`
`hits[].data.groupIssueHistory`	`boolean`
`hits[].data.icon`	`string`
`hits[].data.id`	`string`
`hits[].data.inviteHash`	`string`
`hits[].data.issueCount`	`number`
`hits[].data.issueEstimationAllowZero`	`boolean`
`hits[].data.issueEstimationExtended`	`boolean`
`hits[].data.issueEstimationType`	`string`
`hits[].data.key`	`string`
`hits[].data.markedAsDuplicateWorkflowState`	`object`
`hits[].data.markedAsDuplicateWorkflowStateId`	`string`
`hits[].data.name`	`string`
`hits[].data.parentTeamId`	`string`
`hits[].data.private`	`boolean`
`hits[].data.requirePriorityToLeaveTriage`	`boolean`
`hits[].data.scimManaged`	`boolean`
`hits[].data.setIssueSortOrderOnStateChange`	`string`
`hits[].data.timezone`	`string`
`hits[].data.triageEnabled`	`boolean`
`hits[].data.triageIssueStateId`	`string`
`hits[].data.upcomingCycleCount`	`number`
`hits[].data.updatedAt`	`string`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Users

Users List

Returns a paginated list of users in the organization via GraphQL

Python SDK

await linear.users.list()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`first`	`integer`	No	Number of items to return (max 250)
`after`	`string`	No	Cursor to start after (for pagination)

Records

Field Name	Type	Description
`data`	`object`

Users Get

Get a single user by ID via GraphQL

Python SDK

await linear.users.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	User ID

Records

Field Name	Type	Description
`data`	`object`

Users Search

Search and filter users records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await linear.users.search(
    query={"filter": {"eq": {"active": True}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"active": True}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`active`	`boolean`
`admin`	`boolean`
`avatarBackgroundColor`	`string`
`avatarUrl`	`string`
`createdAt`	`string`
`createdIssueCount`	`number`
`displayName`	`string`
`email`	`string`
`guest`	`boolean`
`id`	`string`
`initials`	`string`
`inviteHash`	`string`
`isMe`	`boolean`
`lastSeen`	`string`
`name`	`string`
`teamIds`	`array`
`teams`	`object`
`timezone`	`string`
`updatedAt`	`string`
`url`	`string`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.active`	`boolean`
`hits[].data.admin`	`boolean`
`hits[].data.avatarBackgroundColor`	`string`
`hits[].data.avatarUrl`	`string`
`hits[].data.createdAt`	`string`
`hits[].data.createdIssueCount`	`number`
`hits[].data.displayName`	`string`
`hits[].data.email`	`string`
`hits[].data.guest`	`boolean`
`hits[].data.id`	`string`
`hits[].data.initials`	`string`
`hits[].data.inviteHash`	`string`
`hits[].data.isMe`	`boolean`
`hits[].data.lastSeen`	`string`
`hits[].data.name`	`string`
`hits[].data.teamIds`	`array`
`hits[].data.teams`	`object`
`hits[].data.timezone`	`string`
`hits[].data.updatedAt`	`string`
`hits[].data.url`	`string`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Comments

Comments List

Returns a paginated list of comments for an issue via GraphQL

Python SDK

await linear.comments.list(
    issue_id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "comments",
    "action": "list",
    "params": {
        "issueId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`issueId`	`string`	Yes	Issue ID to get comments for
`first`	`integer`	No	Number of items to return (max 250)
`after`	`string`	No	Cursor to start after (for pagination)

Records

Field Name	Type	Description
`data`	`object`

Comments Get

Get a single comment by ID via GraphQL

Python SDK

await linear.comments.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "comments",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Comment ID

Records

Field Name	Type	Description
`data`	`object`

Comments Create

Create a new comment on an issue via GraphQL mutation

Python SDK

await linear.comments.create(
    issue_id="<str>",
    body="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "comments",
    "action": "create",
    "params": {
        "issueId": "<str>",
        "body": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`issueId`	`string`	Yes	The ID of the issue to add the comment to
`body`	`string`	Yes	The comment content in markdown

Records

Field Name	Type	Description
`data`	`object`

Comments Update

Update an existing comment via GraphQL mutation

Python SDK

await linear.comments.update(
    id="<str>",
    body="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "comments",
    "action": "update",
    "params": {
        "id": "<str>",
        "body": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	The ID of the comment to update
`body`	`string`	Yes	The new comment content in markdown

Records

Field Name	Type	Description
`data`	`object`

Comments Search

Search and filter comments records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await linear.comments.search(
    query={"filter": {"eq": {"body": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "comments",
    "action": "search",
    "params": {
        "query": {"filter": {"eq": {"body": "<str>"}}}
    }
}'

Parameters

Parameter Name	Type	Required	Description
`query`	`object`	Yes	Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
`query.filter`	`object`	No	Filter conditions
`query.sort`	`array`	No	Sort conditions
`limit`	`integer`	No	Maximum results to return (default 1000)
`cursor`	`string`	No	Pagination cursor from previous response's next_cursor
`fields`	`array`	No	Field paths to include in results

Searchable Fields

Field Name	Type	Description
`body`	`string`
`bodyData`	`string`
`createdAt`	`string`
`editedAt`	`string`
`id`	`string`
`issue`	`object`
`issueId`	`string`
`parent`	`object`
`parentCommentId`	`string`
`resolvingCommentId`	`string`
`resolvingUserId`	`string`
`updatedAt`	`string`
`url`	`string`
`user`	`object`
`userId`	`string`

Field Name	Type	Description
`hits`	`array`	List of matching records
`hits[].id`	`string`	Record identifier
`hits[].score`	`number`	Relevance score
`hits[].data`	`object`	Record data containing the searchable fields listed above
`hits[].data.body`	`string`
`hits[].data.bodyData`	`string`
`hits[].data.createdAt`	`string`
`hits[].data.editedAt`	`string`
`hits[].data.id`	`string`
`hits[].data.issue`	`object`
`hits[].data.issueId`	`string`
`hits[].data.parent`	`object`
`hits[].data.parentCommentId`	`string`
`hits[].data.resolvingCommentId`	`string`
`hits[].data.resolvingUserId`	`string`
`hits[].data.updatedAt`	`string`
`hits[].data.url`	`string`
`hits[].data.user`	`object`
`hits[].data.userId`	`string`
`next_cursor`	`string \| null`	Cursor for next page of results
`took_ms`	`number`	Query execution time in milliseconds

Linear full reference

File contents

Linear full reference

Supported entities and actions

Issues

Issues List

Python SDK

API

Parameters

Records

Meta

Issues Get

Python SDK

API

Parameters

Records

Issues Create

Python SDK

API

Parameters

Records

Issues Update

Python SDK

API

Parameters

Records

Issues Search

Python SDK

API

Parameters

Searchable Fields

Projects

Projects List

Python SDK

API

Parameters

Records

Meta

Projects Get

Python SDK

API

Parameters

Records

Projects Search

Python SDK

API

Parameters

Searchable Fields

Teams

Teams List

Python SDK

API

Parameters

Records

Meta

Teams Get

Python SDK

API

Parameters

Records

Teams Search

Python SDK

API

Parameters

Searchable Fields

Users

Users List

Python SDK

API

Parameters

Records

Users Get

Python SDK

API

Parameters

Records

Users Search

Python SDK

API

Parameters