Docs / Workflows / Integrations / Linear
Linear
Read and manage Linear issues, projects, labels and customer needs.
What you can do
Each Linear integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with Linear.
- Bug reports
- Create an issue from each bug report your support team receives.
- Weekly summary
- Post a weekly summary of finished issues to your team.
- Customer replies
- Comment on an issue when the customer replies.
Connection scope
The connection belongs to one Linear workspace. Issues accept a workspace identifier such as ENG-123 or a UUID. Other actions accept the names, slugs or IDs their fields specify. Team and user lookups identify the people and teams used by writes.
Connecting
Authorize OAIZ in Linear and choose the workspace to connect. OAIZ installs as an app actor, so it can be mentioned or assigned work in Linear.
The authorization requests read, write, issues:create, comments:create, initiative:read, customer:read, app:mentionable and app:assignable. The connection’s access and Linear’s team settings govern which items it can read or change.
Read actions
- Get Issue
- Read an issue’s details, optionally including relations and the latest 100 comments.
- List Issues
- Read issues filtered by team, assignee, state, project, priority or label, with cursor pagination.
- Search Issues
- Search issue titles, descriptions and optional comments, with relevance-ranked snippets.
- Get Project
- Get project details by name, slug, or UUID.
- List Projects
- Browse and filter projects with cursor pagination.
- Search Projects
- Search project names, optionally filtered by status, lead or health.
- List Teams
- List available teams with pagination.
- List Initiatives
- Browse and filter initiatives with cursor pagination.
- Get Initiative
- Get initiative details by name, slug, or UUID.
- List Labels
- List workspace and team-scoped labels with pagination.
- Get Customer
- Get customer details by name or UUID.
- List Customers
- List customers with cursor pagination.
- List Customer Needs
- List customer needs with cursor pagination.
- List Users
- List workspace or team users, or search the workspace by name or email.
Write actions
- Save Issue
- Create an issue with a team and title, or update one by identifier or UUID. Supplied labels replace its complete label set.
- Save Comment
- Create a comment on an issue or update an existing comment by ID.
- Save Project
- Create a project with a name and teams, or update an existing project by ID.
- Save Project Update
- Create or update a project’s status message and health.
- Save Label
- Create or update a workspace or team label. The app’s permissions and the team’s label settings govern changes.
- Save Customer
- Create a customer with a name or update an existing customer by ID.
- Delete Customer
- Delete a customer by UUID.
- Save Customer Need
- Create or update a customer need linked to an issue.
- Delete Customer Need
- Delete a customer need by UUID.
Events
Linear webhooks report supported issue, comment, project, cycle, initiative, customer and customer-need changes. Update events include changed fields and selected previous values. Event IDs let subsequent actions read the current object.