Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.anyshift.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Linear Integration

Connect Linear to give Annie visibility into the engineering work behind your infrastructure. During an incident or chat session, Annie can search Linear for related tickets, retrieve issue details, and tie infrastructure changes back to the issues that requested them.

​
Setup Guide

​
1. Create a Linear personal API key

  1. In Linear, open Settings → My Account → Security & access → API keys, or jump straight to the creation flow at https://linear.app/<your-workspace>/settings/account/security/api-keys/new.
  2. Give the key a label (e.g. Anyshift / Annie) and click Create key.
  3. Copy the generated API key. Linear only shows it once.
Personal API keys inherit the permissions of the user who created them. For least-privilege access, create the key from an account that has only the workspace access you want Annie to have.

​
2. Find your workspace URL key

The workspace URL key is the slug in your Linear URL, immediately after linear.app/. For example, if your workspace lives at https://linear.app/acme, your workspace URL key is acme. You can paste the full URL into the Anyshift form. Anyshift strips the linear.app/ prefix and any trailing slash automatically.

​
3. Connect Linear to Anyshift

  1. Go to the Linear integration page.
  2. Click New credentials.
  3. Fill in the form fields below and click Save.

​
Display name

A human-readable label for this credential (e.g. Engineering Workspace). Used only to identify the credential in the Anyshift UI.

​
Workspace URL key

The slug for your Linear workspace (e.g. acme). Pasting the full URL also works.

​
API key

Paste the personal API key you copied in step 1. Anyshift validates the credentials against Linear’s GraphQL API on save. The credential is stored even if validation fails, so you can fix and retry without re-entering the form.

​
Required Permissions

Annie performs read-only operations on your Linear workspace. The personal API key grants access based on the permissions of the user that created it. The Linear user behind the key needs access to:
  • View issues
  • View teams and team members
  • View projects
Annie does not create, modify, or delete any issues, comments, or other content in your Linear workspace.

​
How It Works

Anyshift’s agent gateway authenticates against Linear’s GraphQL API using the personal API key you provided. The token is encrypted at rest (KMS) and only decrypted in-process when Annie makes a Linear call. Once connected, Annie’s AI agent can:
  • Search your workspace — Free-text search across issues by title, description, and identifier.
  • Read issues — Retrieve a single issue by identifier (e.g. ENG-42) with its team, state, assignee, labels, description, parent, and project.
  • Browse teams — List teams in the workspace or fetch a specific team by key (e.g. ENG), including members and active issues.
  • Browse projects — List projects in the workspace or fetch a specific project by slug or UUID.
  • Resolve the workspace — Look up the authenticated user (viewer) and their organization to confirm what the credential can see.

​
Example use cases

  • “Find the Linear issue that tracks the database migration we shipped last Tuesday.”
  • “What’s the engineering ticket behind this Terraform change?”
  • “Pull the open issues in the Platform team that mention Redis.”
  • “What project does ENG-1234 belong to?”

​
Security & scope

  • Personal API keys inherit the permissions of the user that created them. To restrict what Annie can see, create the key from a Linear account with scoped access.
  • The API key is encrypted at rest using AWS KMS and only decrypted in-process by Anyshift’s gateway.
  • All communication with Linear uses HTTPS/TLS.
  • You can revoke access at any time by deleting the personal API key in Linear’s API settings.
Anyshift + Linear = Annie ties every infrastructure change and incident back to the engineering work that drives it.