Search documentation

Search for a topic, a control, or an event type.

    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.