Skip to main content

​
➿ Linear (team feature)

Linear connects at the team level. Generate a Linear API key and provide the team ID the agent should target. Use the Linear card on the Integrations page—Configure on first use, Update to change it later. Saved credentials apply to the whole workspace. Placeholder: Linear API key settings

​
What you need

  • Linear API Key
  • Linear Team ID for the team you want Nota to use
  • Admin access to Integrations → Linear in the left nav

​
Create a Linear API key

  1. Open Linear and click your avatar → Settings.
  2. Under Account, select API.
  3. Click Create new personal API key, name it (e.g., “Nota”), and copy the value shown once.
  4. Keep the key private; treat it like a password.

​
Find your Linear team ID

Option 1 — from the URL:
  1. Open your team in Linear: https://linear.app/<workspace>/team/<team-key>/....
  2. The team-key portion uniquely identifies the team (e.g., pl for Platform). Use this as the team ID.
Option 2 — via GraphQL (precise): 
curl https://api.linear.app/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: <YOUR_LINEAR_API_KEY>" \
  -d '{ "query": "{ teams { id name key } }" }'
Use the id value that matches your team name/key.

​
Add credentials to Nota

  1. Open Integrations in the left nav and select the Linear card.
  2. Paste your Linear API Key.
  3. Enter the Linear Team ID (team key or id from the GraphQL query).
  4. Save. The key is stored for the team—no environment variable or redeploy required.