Sign inGet started
Docs
Get started

Linear API Authentication

How to authenticate Linear API requests: one Bearer API key plus a connectionId. MindCloud runs the OAuth flow and refreshes Linear tokens for you.

Every Linear API request through MindCloud needs two things: a MindCloud API Key and a connectionId for your Linear account. This page covers both, plus exactly how to send them, so you do not need to visit any other page to get authenticated.

Steps to authenticate

  1. Create a MindCloud account at app.mindcloud.co if you do not already have one.
  2. Generate a MindCloud API Key in API Keys. This is the Bearer token you send on every request. Keep it on your server.
  3. Create a Linear connection in Connections. Linear uses OAuth. When you create the connection, you are redirected to sign in to Linear and approve access — MindCloud stores the resulting tokens and refreshes them automatically, so your integration never has to.
  4. Copy the connection’s connectionId — you will send it on every request alongside your MindCloud API Key.

How requests are authenticated

Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected Linear account that should run the action. MindCloud stores and refreshes the Linear credentials behind that connection, so you never send provider tokens with your requests.

Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions.

For example, calling List Teams with an Linear connection looks like this:

curl --request GET \
  --url "https://connect.mindcloud.co/v1/universal/linear/latest/actions/list-teams" \
  --header "Authorization: Bearer $MINDCLOUD_API_KEY" \
  --get \
  --data-urlencode "connectionId=$CONNECTION_ID"

The Authorization: Bearer <your MindCloud API Key> header authenticates you to MindCloud; the connectionId tells MindCloud which Linear account to run the action against. Missing or invalid Authorization returns 401, and a missing or mismatched connectionId returns 400.

How to set up your connection?

You need access to your Linear account. If you do not see the Personal API keys section, your workspace may require an admin to allow member API keys first.

  1. Open your Personal API keys page in Linear

    In Linear, open your account settings and go to Security & Access to manage personal API keys.

    Settings → Account → Security & Access

  2. Create a new API key

    Create a personal API key. Give it the permissions you need for your workflow. If your workspace restricts member API keys, ask a Linear admin to enable them or create the key for you.

  3. Paste the API key into the connection form

    Return to the connection form and paste the new key into the API Key field.

Keep your key safe

Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs. Anyone with the key can call the Universal API as your MindCloud account, across every connection you have created.