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

# Linear Provider

> Linear Provider is a provider for fetching data and creating issues in Linear app.

## Authentication

This provider requires authentication.

* **api\_token**: Linear API Token (required: True, sensitive: True)
* **ticket\_creation\_url**: URL for creating new tickets (required: False, sensitive: False)

## In workflows

This provider can be used in workflows.

As "step" to query data, example:

```yaml theme={null}
steps:
    - name: Query linear
      provider: linear
      config: "{{ provider.my_provider_name }}"
      with:
        team_name: {value}  
```

As "action" to make changes or update data, example:

```yaml theme={null}
actions:
    - name: Query linear
      provider: linear
      config: "{{ provider.my_provider_name }}"
      with:
        team_name: {value}  
        project_name: {value}  
        title: {value}  
        description: {value}  
        priority: {value}  
```

If you need workflow examples with this provider, please raise a [GitHub issue](https://github.com/keephq/keep/issues).

## How to set up

The Linear Provider uses `api_token` for request authorization. You need to provider the following:

* **api\_token** (requires): The personal api key for your linear app.
  * How to obtain:
    1. Visit the Linear app or website.
    2. Log in to your Linear account.
    3. Navigate to your account settings -.
    4. Navigate to the API page.
    5. Under Personal API keys section generate the key.
    6. Copy the generated API token.

## Notes

* This provider allows you to query projects for the given Linear team.
* This provider allows you to notify (create issue) inside Linear app for given project and team.

## Useful Links

* [Linear](https://linear.app)
* [Linear Docs](https://developers.linear.app/docs/graphql/working-with-the-graphql-api)