Connect Linear

The Linear integration lets you create issues from inside OpenAPI Studio — usually when reviewing a spec, running a recipe, or reading execution history.

Connecting

From workspace settings → Integrations, click Connect next to Linear. Approve the scopes:

• read — list teams, projects, and labels.
• issues:create — file new issues.

We don’t request write for arbitrary issue editing — only creation. After approval, Linear shows as Connected.

Filing an issue

From the action menu of any endpoint or recipe run, pick File Linear issue. The dialog pre-populates:

• Team — your default Linear team (changeable per-issue).
• Title — operation name + the action you were doing.
• Description — a markdown summary including a deep link back to the editor / runner / recipe run, the request and response if relevant, and any error message.
• Labels — optional, picked from your team’s labels.

Edit any field, click Create, and the issue lands in Linear with a back-link in the description.

Default team

To skip picking a team every time, set a workspace-default in Workspace settings → Integrations → Linear → Default team.

Disconnecting

Workspace settings → Integrations → Linear → Disconnect. The token is revoked. Issues already filed remain in Linear unchanged.