> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear Changelog

> Release history for the Linear connector. Each version lists what changed and which actions were affected.

<Card title="Linear connector" icon="arrow-left" href="/connectors/linear" horizontal>
  Back to the connector overview, authentication methods, and actions.
</Card>

<Update label="v1.1.1" description="24 Jul 2026">
  `bug-fix`

  Fixed tool-selection issues from MCP testing - delete\_document now documents the working move-to-trash and update\_document drops the non-functional trashed field, delete\_attachment and update\_attachment are disambiguated, and create\_initiative\_update marks body optional with body and bodyData mutually exclusive.

  <AccordionGroup>
    <Accordion title="Changed · 5 actions updated">
      `linear_create_initiative_update`, `linear_delete_attachment`, `linear_delete_document`, `linear_update_attachment`, `linear_update_document`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.1.0" description="22 Jul 2026">
  `new-actions` `bug-fix`

  Added list\_favorites and list\_team\_memberships so delete\_favorite and delete\_team\_membership can resolve the IDs they need. Fixed customer tier renames and the list\_comments issue filter, and clarified several tool descriptions (file\_upload, batch\_update\_issues, update\_user, update\_customer\_need priority, list\_issue\_labels, create\_favorite). No authentication changes.

  <AccordionGroup>
    <Accordion title="Added · 2 new actions">
      `linear_list_favorites`, `linear_list_team_memberships`
    </Accordion>

    <Accordion title="Changed · 11 actions updated">
      `linear_batch_update_issues`, `linear_create_customer_need`, `linear_create_favorite`, `linear_file_upload`, `linear_get_customer_need`, `linear_get_customer_tier`, `linear_list_comments`, `linear_list_issue_labels`, `linear_update_customer_need`, `linear_update_customer_tier`, `linear_update_user`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.0.2" description="21 Jul 2026">
  `bug-fix` `guide-fix`

  Added the admin scope to the default OAuth 2.0 scope request (read,write,admin) so admin-gated actions — webhook management, organization/workspace settings, and customer status, customer tier, and project status create/update/delete — work after reconnecting; Linear treats admin as a separate token grant from the user's role, so these previously failed with "admin required" even for workspace admins. Corrected requiredScopes from write to admin on the customer-status, customer-tier, and project-status create/update/delete/archive actions to match Linear's real permission requirements (their read/list/get actions remain on read). Also updated the OAuth scope guide to explain the admin requirement. Existing OAuth connections must reconnect to grant the admin scope.

  <AccordionGroup>
    <Accordion title="Changed · 136 actions updated">
      `linear_archive_cycle`, `linear_archive_initiative`, `linear_archive_issue`, `linear_archive_project`, `linear_archive_project_status`, `linear_batch_create_issues`, `linear_batch_update_issues`, `linear_complete_release`, `linear_create_attachment`, `linear_create_comment`, `linear_create_custom_view`, `linear_create_customer`, `linear_create_customer_need`, `linear_create_customer_status`, `linear_create_customer_tier`, `linear_create_cycle`, `linear_create_document`, `linear_create_favorite`, `linear_create_initiative`, `linear_create_initiative_to_project`, `linear_create_initiative_update`, `linear_create_issue`, `linear_create_issue_label`, `linear_create_issue_relation`, `linear_create_notification_subscription`, `linear_create_project`, `linear_create_project_label`, `linear_create_project_milestone`, `linear_create_project_status`, `linear_create_project_update`, `linear_create_reaction`, `linear_create_release`, `linear_create_team`, `linear_create_team_membership`, `linear_create_template`, `linear_create_webhook`, `linear_create_workflow_state`, `linear_delete_attachment`, `linear_delete_comment`, `linear_delete_custom_view`, `linear_delete_customer`, `linear_delete_customer_need`, `linear_delete_customer_status`, `linear_delete_customer_tier`, `linear_delete_document`, `linear_delete_favorite`, `linear_delete_initiative`, `linear_delete_initiative_to_project`, `linear_delete_issue`, `linear_delete_issue_label`, `linear_delete_issue_relation`, `linear_delete_project`, `linear_delete_project_label`, `linear_delete_project_milestone`, `linear_delete_reaction`, `linear_delete_release`, `linear_delete_team`, `linear_delete_team_membership`, `linear_delete_template`, `linear_delete_webhook`, `linear_file_upload`, `linear_get_agentSession`, `linear_get_application_info`, `linear_get_comment`, `linear_get_customer`, `linear_get_customer_need`, `linear_get_customer_status`, `linear_get_customer_tier`, `linear_get_cycle`, `linear_get_document`, `linear_get_external_user`, `linear_get_initiative`, `linear_get_issue`, `linear_get_issue_label`, `linear_get_project`, `linear_get_project_label`, `linear_get_project_milestone`, `linear_get_project_status`, `linear_get_team`, `linear_get_user`, `linear_get_viewer`, `linear_get_webhook`, `linear_get_workflow_state`, `linear_issue_filter_suggestion`, `linear_list_agentSessions`, `linear_list_comments`, `linear_list_customer_needs`, `linear_list_customer_statuses`, `linear_list_customer_tiers`, `linear_list_customers`, `linear_list_cycles`, `linear_list_documents`, `linear_list_external_users`, `linear_list_initiatives`, `linear_list_issue_labels`, `linear_list_issues`, `linear_list_project_labels`, `linear_list_project_milestones`, `linear_list_project_statuses`, `linear_list_projects`, `linear_list_teams`, `linear_list_users`, `linear_list_webhooks`, `linear_list_workflow_states`, `linear_organization_invite_create`, `linear_organization_update`, `linear_resolve_comment`, `linear_rotate_webhook_secret`, `linear_search_issues`, `linear_unarchive_issue`, `linear_unified_get_me`, `linear_unresolve_comment`, `linear_update_attachment`, `linear_update_comment`, `linear_update_custom_view`, `linear_update_customer`, `linear_update_customer_need`, `linear_update_customer_status`, `linear_update_customer_tier`, `linear_update_cycle`, `linear_update_document`, `linear_update_initiative`, `linear_update_issue`, `linear_update_issue_label`, `linear_update_project`, `linear_update_project_label`, `linear_update_project_milestone`, `linear_update_project_status`, `linear_update_release`, `linear_update_team`, `linear_update_template`, `linear_update_user`, `linear_update_webhook`, `linear_update_workflow_state`, `linear_upsert_customer`, `linear_user_suspend`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.0.1" description="17 Jul 2026">
  `guide-fix` `improvement`

  Added a connection test action (get\_viewer) for the API Key auth method, added portal-step screenshots to the API Key config and OAuth 2.0 setup connection guides, and fixed guide audit findings — added the create-key step, corrected UI labels (Security & access, Redirect URIs, the New OAuth application + button), documented the optional OAuth application fields and toggles, added a Developer URL example, and added detailed OAuth scope guidance plus the minimum Read permission requirement.
</Update>