---
title: "Authorize Linear integration"
method: GET
path: "/v1/integrations/linear/oauth/authorize"
tags: ["integrations"]
---

# Authorize Linear integration

`GET /v1/integrations/linear/oauth/authorize`

Start Linear OAuth for the current organization.

## Query parameters

- `store_name` string, nullable — Ingestion store name. A store that already exists is shared: every data source connected to it ingests into it, except another installation of the same account, which would ingest every item again. Without it, the account's default store, numbered past a store another installation of the account feeds. Rejected with 422 when the connect refreshes an existing installation and names a store other than its own.
- `new_store` boolean — Ingest into a store created for this connection: the connect fails with 409 when `store_name` names a store that already exists, and without `store_name` the default name is numbered past existing stores. Rejected with 422 when the connect refreshes an existing installation, which keeps its store.
- `metadata_contextualization` boolean — Contextualize chunks with the connector's curated metadata fields
- `file_contextualization` boolean — Generate an LLM context for each chunk situating it within the full document
- `ingestion_mode` 'fast' | 'high_quality' — Strategy for adding a file to a store.

## Other responses

- `307` — Redirect to Linear OAuth
- `409` — The store already receives data from another installation of the same account, `new_store` names a store that already exists, a Slack workspace bot is already installed by a different Mixedbread organization, or a Notion internal integration that is already connected is asked for a new or different store
- `422` — The request failed validation, the credentials it carries were rejected, or `new_store` is set on a connect that refreshes an existing installation

## Changes

- **2026-09-26** `9c6c72afde2d` — 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the new optional `query` request parameter `new_store`
  - added the non-success response with the status `409`
  - added the required property `code` to the response with the `422` status
  - …2 more

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/linear/oauth/authorize/get.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/9c6c72afde2d?raw)