# Fiche connecteur Linear (API key) Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno. Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur. ## Linear (API key) URL : https://get-bruno.com/features/connectors/linear-app Référence texte : https://get-bruno.com/features/connectors/linear-app/reference.txt Origine : Catalogue Pipedream Statut : Catalogue Pipedream — connexion à vérifier Catégories : Organisation du travail Description : Linear sert à gérer des projets logiciels, des sprints, des tâches et le suivi des bogues dans un espace de travail. Le catalogue Pipedream propose des actions pour créer, consulter, lister et mettre à jour des issues, des projets et des initiatives, ainsi que pour gérer les commentaires, les mises à jour associées et quelques déclencheurs instantanés. Authentification : API key Présentation : Linear sert à gérer des projets logiciels, des sprints, des tâches et le suivi des bogues dans un espace de travail. Le catalogue Pipedream propose des actions pour créer, consulter, lister et mettre à jour des issues, des projets et des initiatives, ainsi que pour gérer les commentaires, les mises à jour associées et quelques déclencheurs instantanés. Usage : Créer une issue dans l’équipe Engineering Exemple de demande : Je veux créer une issue pour le bogue de redirection de connexion sur mobile dans l’équipe Engineering, si son identifiant est disponible. Résultat attendu : Une nouvelle issue Linear est créée dans l’équipe fournie avec le titre indiqué. À préciser : Identifiant de l’équipe ; Titre de l’issue Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/linear-app/actions/get-teams ; https://pipedream.com/apps/linear-app/actions/create-issue Usage : Retrouver une issue et la passer en Done Exemple de demande : Je veux retrouver l’issue ENG-42 sur le dossier de paiement, puis la faire passer en Done si c’est bien la bonne. Résultat attendu : L’issue est retrouvée, puis son état est mis à jour avec la valeur fournie sans modifier les autres champs non indiqués. À préciser : Identifiant lisible de l’issue ou UUID ; Identifiant de l’état cible Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/linear-app/actions/get-issue ; https://pipedream.com/apps/linear-app/actions/list-workflow-states ; https://pipedream.com/apps/linear-app/actions/update-issue Usage : Créer un projet puis commenter une issue Exemple de demande : Je veux créer le projet Mobile App v2, puis ajouter un commentaire sur l’issue ENG-42 pour signaler la correction en cours. Résultat attendu : Le projet est créé, puis un commentaire est ajouté à l’issue après récupération de son identifiant. À préciser : Nom du projet ; Identifiant de l’équipe porteuse ; Identifiant de l’issue ou UUID ; Texte du commentaire Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/linear-app/actions/create-project ; https://pipedream.com/apps/linear-app/actions/get-teams ; https://pipedream.com/apps/linear-app/actions/get-issue ; https://pipedream.com/apps/linear-app/actions/create-comment Limites propres au service : Le catalogue n’expose qu’une seule action de retrait : retirer un label d’issue. Créer ou mettre à jour une issue, un projet ou une initiative demande souvent d’obtenir d’abord les identifiants nécessaires (équipe, état, utilisateur, label ou cible). La recherche d’issues renvoie jusqu’à 200 résultats et plusieurs actions de liste utilisent first, after et pageInfo.endCursor. Les déclencheurs instantanés existent dans le catalogue, mais aucun exemple d’action ne les exécute. Vocabulaire français : Créer un commentaire — Ajoute un commentaire à une issue Linear déjà ciblée par son identifiant. (https://pipedream.com/apps/linear-app/actions/create-comment) Vocabulaire français : Créer une initiative — Crée une nouvelle initiative pour suivre un objectif stratégique transverse. (https://pipedream.com/apps/linear-app/actions/create-initiative) Vocabulaire français : Créer une mise à jour d’initiative — Publie un compte rendu d’avancement sur une initiative existante. (https://pipedream.com/apps/linear-app/actions/create-initiative-update) Vocabulaire français : Créer une issue — Crée une nouvelle issue dans une équipe Linear. L’identifiant de l’équipe et le titre sont obligatoires ; les autres champs sont facultatifs. (https://pipedream.com/apps/linear-app/actions/create-issue) Vocabulaire français : Créer un projet — Crée un projet Linear pour regrouper des issues liées entre elles. (https://pipedream.com/apps/linear-app/actions/create-project) Vocabulaire français : Créer une mise à jour de projet — Publie un compte rendu d’avancement sur un projet existant. (https://pipedream.com/apps/linear-app/actions/create-project-update) Vocabulaire français : Obtenir une mise à jour d’initiative — Récupère une mise à jour d’initiative à partir de son identifiant. (https://pipedream.com/apps/linear-app/actions/get-initiative-update) Vocabulaire français : Obtenir une issue — Récupère une issue unique par UUID ou par identifiant lisible. (https://pipedream.com/apps/linear-app/actions/get-issue) Vocabulaire français : Obtenir une mise à jour de projet — Récupère une mise à jour de projet à partir de son identifiant. (https://pipedream.com/apps/linear-app/actions/get-project-update) Vocabulaire français : Obtenir les équipes — Liste les équipes de l’espace de travail pour trouver les identifiants valides. (https://pipedream.com/apps/linear-app/actions/get-teams) Vocabulaire français : Obtenir les issues d’une vue — Récupère les issues filtrées par une vue personnalisée enregistrée. (https://pipedream.com/apps/linear-app/actions/get-view-issues) Vocabulaire français : Lister les commentaires — Liste les commentaires associés à une issue ou à un texte recherché. (https://pipedream.com/apps/linear-app/actions/list-comments) Vocabulaire français : Lister les mises à jour d’initiative — Liste les mises à jour publiées sur une initiative, avec option de filtrage. (https://pipedream.com/apps/linear-app/actions/list-initiative-updates) Vocabulaire français : Lister les initiatives — Liste les initiatives existantes, avec filtre possible par nom ou statut. (https://pipedream.com/apps/linear-app/actions/list-initiatives) Vocabulaire français : Lister les labels — Liste les labels d’issues disponibles dans l’espace de travail. (https://pipedream.com/apps/linear-app/actions/list-labels) Vocabulaire français : Lister les labels de projet — Liste les labels de projet disponibles pour créer ou mettre à jour un projet. (https://pipedream.com/apps/linear-app/actions/list-project-labels) Vocabulaire français : Lister les statuts de projet — Liste les statuts utilisables pour un projet Linear. (https://pipedream.com/apps/linear-app/actions/list-project-statuses) Vocabulaire français : Lister les mises à jour de projet — Liste les mises à jour publiées sur un projet, avec filtrage possible. (https://pipedream.com/apps/linear-app/actions/list-project-updates) Vocabulaire français : Lister les projets — Liste les projets existants, avec option de filtrage par équipe. (https://pipedream.com/apps/linear-app/actions/list-projects) Vocabulaire français : Lister les utilisateurs — Liste les membres de l’espace de travail pour trouver des identifiants d’assignation ou de propriétaire. (https://pipedream.com/apps/linear-app/actions/list-users) Vocabulaire français : Lister les vues — Liste les vues enregistrées réutilisables pour filtrer des issues. (https://pipedream.com/apps/linear-app/actions/list-views) Vocabulaire français : Lister les états de workflow — Liste les états d’issues avec leur nom, type et équipe associée. (https://pipedream.com/apps/linear-app/actions/list-workflow-states) Vocabulaire français : Retirer un label d’une issue — Retire un label d’une issue de façon réversible. (https://pipedream.com/apps/linear-app/actions/remove-label-from-issue) Vocabulaire français : Rechercher des issues — Recherche des issues par équipe, projet, personne assignée, labels, état ou texte. (https://pipedream.com/apps/linear-app/actions/search-issues) Vocabulaire français : Mettre à jour une initiative — Modifie une initiative existante en ne changeant que les champs fournis. (https://pipedream.com/apps/linear-app/actions/update-initiative) Vocabulaire français : Mettre à jour une issue — Modifie une issue existante en ne changeant que les champs fournis. (https://pipedream.com/apps/linear-app/actions/update-issue) Vocabulaire français : Déclencheur: état d’une issue modifié immédiatement — Émet un événement quand l’état d’une issue change. (https://pipedream.com/apps/linear-app/triggers/new-issue-status-updated) Vocabulaire français : Déclencheur: issue modifiée immédiatement — Émet un événement quand une issue est modifiée, hors changement d’état. (https://pipedream.com/apps/linear-app/triggers/issue-updated-instant) Vocabulaire français : Déclencheur: nouveau commentaire créé immédiatement — Émet un événement quand un commentaire est ajouté à une issue. (https://pipedream.com/apps/linear-app/triggers/comment-created-instant) Vocabulaire français : Déclencheur: nouvelle issue créée immédiatement — Émet un événement quand une issue est créée. (https://pipedream.com/apps/linear-app/triggers/issue-created-instant) Vocabulaire français : Déclencheur: nouvelle mise à jour de projet écrite immédiatement — Émet un événement quand une mise à jour de projet est publiée. (https://pipedream.com/apps/linear-app/triggers/new-projectupdate-created) Vocabulaire français : Déclencheur: projet modifié immédiatement — Émet un événement quand un projet est modifié. (https://pipedream.com/apps/linear-app/triggers/project-updated-instant) - action : Create Comment — Add a comment to a Linear issue. Use Search Issues to find the target issue ID first. Returns the new comment's ID and body. Example: issueId: "iss_01abc" , body: "Fixed in PR #123." → returns {success: true, comment: {id: "cmt_xyz", body: "Fixed in PR #123."}} . See the documentation (https://pipedream.com/apps/linear-app/actions/create-comment) - action : Create Initiative — Create a new initiative in Linear to track a cross-team strategic goal. Initiatives group multiple projects toward a shared objective. Use List Users to find a valid owner ID. Example: initiativeName: "Q4 Platform Upgrade" , status: "Active" , targetDate: "2024-12-31" → returns {success: true, initiative: {id: "ini_01abc", name: "Q4 Platform Upgrade"}} . See the documentation (https://pipedream.com/apps/linear-app/actions/create-initiative) - action : Create Initiative Update — Post a status update on a Linear initiative. Use List Initiatives first to obtain the initiative ID. Updates appear in the initiative's activity feed and can include a health status. Example: initiativeId: "b2c3d4e5-0000-0000-0000-000000000002" , body: "Two projects completed; on track for Q4." , health: "onTrack" → returns {success: true, initiativeUpdate: {id: "iu_01xyz"}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/create-initiative-update) - action : Create Issue — Creates a new issue in Linear. Requires a team ID and title; all other fields are optional. Use Get Teams to discover valid team IDs, List Workflow States to find state IDs, List Users to find assignee IDs, and List Labels to find label IDs. To create a sub-issue, set parentId to the parent issue's ID (use Search Issues to find it). Example: teamId: "9d1c3f7e-2b48-4c6a-9f1e-5a7b8c9d0e1f" , title: "Fix login redirect on mobile" → returns {success: true, issue: {id: "iss_01", identifier: "ENG-42", title: "Fix login redirect on mobile"}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/create-issue) - action : Create Project — Create a new project in Linear to track a body of work. Projects group related issues within a team. Use Get Teams for team IDs, List Project Statuses to find status IDs, List Users for member IDs, and List Project Labels for label IDs. Example: teamId: "9d1c3f7e-..." , projectName: "Mobile App v2" , statusId: "s2abc" → returns {success: true, project: {id: "proj_01", name: "Mobile App v2"}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/create-project) - action : Create Project Update — Post a status update on a Linear project. Use List Projects first to obtain the project ID. Updates appear in the project's activity feed. Example: projectId: "a1b2c3d4-0000-0000-0000-000000000001" , body: "Q3 milestone complete; all P0 issues resolved." , health: "onTrack" → returns {success: true, projectUpdate: {id: "pu_01xyz"}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/create-project-update) - action : Get Initiative Update — Retrieve a single initiative update by its ID in Linear. Use List Initiative Updates first to obtain a valid update ID. Returns the full update including id , body , health , createdAt , and author. Example: initiativeUpdateId: "530f4366-88ab-4866-a44b-c2326728c32d" → returns {id: "530f4366-88ab-4866-a44b-c2326728c32d", body: "Two projects completed.", health: "onTrack", createdAt: "2024-01-15T10:00:00Z"} . See the documentation. (https://pipedream.com/apps/linear-app/actions/get-initiative-update) - action : Get Issue — Retrieve a single Linear issue by its UUID or human-readable identifier. Provide exactly one of issueId (UUID) or issueIdentifier (e.g. ENG-42 ). Returns complete issue details: title, description, state, assignee, team, project, labels, and timestamps. Use the optional fields prop to narrow the response to only the keys you need (reduces context for large result sets). Example: issueIdentifier: "ENG-42" → returns {id: "iss_01abc", identifier: "ENG-42", title: "Fix login redirect", state: {name: "In Progress"}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/get-issue) - action : Get Project Update — Retrieve a single project update by its ID in Linear. Use List Project Updates first to obtain a valid update ID. Returns the full update including id , body , health , createdAt , and author. Example: projectUpdateId: "7df5e7f9-a357-4539-ae94-4a004fec635f" → returns {id: "7df5e7f9-a357-4539-ae94-4a004fec635f", body: "Q3 milestone complete.", health: "onTrack", createdAt: "2024-01-15T10:00:00Z"} . See the documentation. (https://pipedream.com/apps/linear-app/actions/get-project-update) - action : Get Teams — Retrieves teams in your Linear workspace. Returns team objects with id , name , key , and more (including internal settings fields). Use this to discover valid team IDs (UUIDs) for creating or filtering issues and projects. Supports pagination: pass after with the previous response's pageInfo.endCursor to load the next page. Use the optional fields prop to narrow the response to only the keys you need (reduces context for large result sets). Example: call with limit: 50 → returns {nodes: [{id: "9d1c3f7e-...", name: "Engineering", key: "ENG"}, ...], pageInfo: {endCursor: "...", hasNextPage: true}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/get-teams) - action : Get View Issues — Retrieve issues filtered by a saved custom view in Linear. Custom views encapsulate pre-configured filters (team, state, assignee, labels, etc.). Use List Views to find the view ID. Use the optional fields prop to narrow the response to only the keys you need (reduces context for large result sets). Example: viewId: "cv1b2c3d4-..." → returns {nodes: [{id: "iss_01", identifier: "ENG-42", title: "Fix login", state: {name: "In Progress"}}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation (https://pipedream.com/apps/linear-app/actions/get-view-issues) - action : List Comments — List comments in Linear, optionally filtered by issue or body text. Returns comment objects with id , body , createdAt , and author details. Supports pagination via first / after . Use Search Issues to find an issue ID to filter by. Example: issueId: "iss_01abc", body: "PR #" → returns {nodes: [{id: "cmt_xyz", body: "Fixed in PR #123.", createdAt: "2024-01-15T10:00:00Z"}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation (https://pipedream.com/apps/linear-app/actions/list-comments) - action : List Initiative Updates — List initiative updates in Linear, optionally scoped to a single initiative. Use List Initiatives to find an initiative ID. Returns update objects with id , body , health , createdAt , and author. Example: initiativeId: "b2c3d4e5-0000-0000-0000-000000000002" , first: 10 → returns {nodes: [{id: "iu_01xyz", body: "Two projects completed.", health: "onTrack"}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-initiative-updates) - action : List Initiatives — List initiatives in Linear, optionally filtered by name or status. Use this to discover valid initiative IDs for creating updates or linking projects. Returns initiative objects with id , name , status , and targetDate . Example: status: "Active" → returns {nodes: [{id: "ini_01abc", name: "Q4 Platform Upgrade", status: "Active"}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation (https://pipedream.com/apps/linear-app/actions/list-initiatives) - action : List Labels — List issue labels in the Linear workspace. Use this to discover valid label names and IDs for creating or filtering issues. Returns label objects with id , name , and color . Example: first: 50 → returns {nodes: [{id: "lbl_bug123", name: "Bug", color: "#ef4444"}, {id: "lbl_fe456", name: "Frontend", color: "#0ea5e9"}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-labels) - action : List Project Labels — List available project labels in the Linear workspace. Use this to discover valid label IDs when creating or updating projects. Returns {nodes, pageInfo} , where each node includes id , name , and optional color . If pageInfo.hasNextPage is true , call again with after set to pageInfo.endCursor to fetch more. Example: returns {nodes: [{id: "9a1b2c3d-0000-0000-0000-000000000007", name: "Frontend", color: "#0ea5e9"}], pageInfo: {endCursor: "9a1b2c3d-0000-0000-0000-000000000007", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-project-labels) - action : List Project Statuses — List available project statuses in the Linear workspace. Use this to discover valid status IDs when creating or updating projects. Returns {nodes, pageInfo} , where each node includes id , name , and type . If pageInfo.hasNextPage is true , call again with after set to pageInfo.endCursor to fetch more. Example: returns {nodes: [{id: "5a1b2c3d-0000-0000-0000-000000000006", name: "Planned", type: "planned"}], pageInfo: {endCursor: "5a1b2c3d-0000-0000-0000-000000000006", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-project-statuses) - action : List Project Updates — List project updates in Linear, optionally scoped to a single project. Use List Projects to find a project ID. Returns update objects with id , body , health , createdAt , and author. Example: projectId: "a1b2c3d4-0000-0000-0000-000000000001" , first: 10 → returns {nodes: [{id: "pu_01xyz", body: "Q3 milestone complete.", health: "onTrack"}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-project-updates) - action : List Projects — List projects in Linear, optionally filtered by team. Returns project objects including id , name , state , priority , and progress history. Use Get Teams to find team IDs. Use the optional fields prop to narrow the response when only specific fields are needed (reduces context for large result sets). Example: teamId: "9d1c3f7e-..." → returns {nodes: [{id: "proj_01", name: "Mobile App v2", state: {name: "In Progress"}}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-projects) - action : List Users — List members of the Linear workspace. Use this to discover valid user IDs for assigning issues or initiatives. Returns {nodes, pageInfo} , where each node includes id , name , and email . If pageInfo.hasNextPage is true , call again with after set to pageInfo.endCursor to fetch more. Example: call with no filters to list all members → returns {nodes: [{id: "abc123", name: "Alice", email: "alice@acme.com"}], pageInfo: {endCursor: "abc123", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-users) - action : List Views — List saved custom views in Linear. Use this to discover valid view IDs for the Get View Issues action. Custom views combine filters (team, assignee, state, labels, etc.) into a reusable saved search. Optionally filter by team. Example: teamId: "9d1c3f7e-..." → returns {nodes: [{id: "cv1abc", name: "My Open Issues", teamId: "9d1c3f7e-..."}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation (https://pipedream.com/apps/linear-app/actions/list-views) - action : List Workflow States — List workflow states (statuses) in Linear. Returns state IDs, names, types (e.g. backlog, started, completed, cancelled), and team info. Optionally filter by team (use the Get Teams action to discover valid team IDs, e.g. 4e80f53c-da9e-4dee-b14e-2cab3e2e8716 ). Example: teamId: "9d1c3f7e-..." → returns {nodes: [{id: "state_done_xyz", name: "Done", type: "completed"}, {id: "state_prog_abc", name: "In Progress", type: "started"}], pageInfo: {endCursor: "...", hasNextPage: false}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/list-workflow-states) - action : Remove Label from Issue — Remove a label from an issue in Linear. The label can be re-added at any time, so this operation is reversible. Use Search Issues to find the issue ID, and List Labels to find the label ID. Example: issueId: "iss_01abc" , labelId: "lbl_bug123" → removes the label and returns {success: true} . See the documentation (https://pipedream.com/apps/linear-app/actions/remove-label-from-issue) - action : Search Issues — Search Linear issues by team, project, assignee, labels, state, or text query. Returns up to 200 matching issues (paginated internally). Use Get Teams for team IDs, List Projects for project IDs, List Workflow States for state IDs, List Users for assignee IDs, and List Labels for label names. Use the optional fields prop to narrow the response to only the keys you need (reduces context size for large result sets). Example: teamId: "9d1c3f7e-...", query: "login redirect" → returns [{id: "iss_01", identifier: "ENG-42", title: "Fix login redirect on mobile", state: {name: "In Progress"}}] . See the documentation. (https://pipedream.com/apps/linear-app/actions/search-issues) - action : Update Initiative — Update an existing initiative in Linear. All fields are optional; only provided fields are updated. Use List Initiatives to find the initiative ID. Example: initiativeId: "b2c3d4e5-0000-0000-0000-000000000002" , status: "Completed" → returns {success: true, initiative: {id: "b2c3d4e5-...", name: "Q4 Platform Upgrade", status: "Completed"}} . See the documentation (https://pipedream.com/apps/linear-app/actions/update-initiative) - action : Update Issue — Updates an existing Linear issue. All fields are optional; only provided fields are changed — prior values are preserved for any omitted field. Use Get Teams for team IDs, List Workflow States for state IDs, List Users for assignee IDs, List Labels for label IDs, and Search Issues for the issue ID. Example: issueId: "iss_01abc" , stateId: "state_done_xyz" → returns {success: true, issue: {id: "iss_01abc", identifier: "ENG-42", state: {name: "Done"}}} . See the documentation. (https://pipedream.com/apps/linear-app/actions/update-issue) - trigger : Issue Status Updated (Instant) — Emit new event when an issue's workflow state changes (e.g., Todo to In Progress). Returns issue with previous and current state info. Can filter by specific target state. See Linear docs for additional info See the documentation. (https://pipedream.com/apps/linear-app/triggers/new-issue-status-updated) - trigger : Issue Updated (Instant) — Emit new event when any issue is updated in Linear. Provides complete issue details with changes. Supports filtering by team and project. Includes all updates except status changes. See Linear docs for additional info See the documentation. (https://pipedream.com/apps/linear-app/triggers/issue-updated-instant) - trigger : New Comment Created (Instant) — Emit new event when a new comment is added to an issue in Linear. Returns comment details including content, author, issue reference, and timestamps. Supports filtering by team. See Linear docs for additional info See the documentation. (https://pipedream.com/apps/linear-app/triggers/comment-created-instant) - trigger : New Issue Created (Instant) — Emit new event when a new issue is created in Linear. Provides complete issue details including title, description, team, assignee, state, and timestamps. Supports filtering by team and project. See Linear docs for additional info See the documentation. (https://pipedream.com/apps/linear-app/triggers/issue-created-instant) - trigger : New Project Update Written (Instant) — Emit new event when a project update (status report) is created in Linear. Returns update content, author, project details, and health status. Filters by team and optionally by project. See Linear docs for additional info See the documentation. (https://pipedream.com/apps/linear-app/triggers/new-projectupdate-created) - trigger : Project Updated (Instant) — Emit new event when a project is updated in Linear. Returns project details including name, description, status, dates, and team info. Supports filtering by specific teams. See Linear docs for additional info See the documentation. (https://pipedream.com/apps/linear-app/triggers/project-updated-instant)