ℹ Only Network Admins can add data sources to Coworker. Contact your network admin for assistance
ℹ You must be an admin for the connected data source in order to successfully connect the tool to Coworker. If you do not have admin access for this tool, you will need to either obtain admin privileges for the tool otherwise add an admin of that tool as an admin on Coworker so they can complete the connection
Prerequisites
A Linear account with sufficient access to the workspace & projects you wish to sync with Coworker Labs.
Generating the credentials
Go to https://linear.app/settings/account/security to start the api key process. Note: Make sure you're on the correct workspace.
Alternatively, go to https://www.linear.app and navigate to the workplace settings in the top left corner. Then, navigate to the Security & access section.
Navigating to workplace settings
2. Create a new API key. First give it a label like "coworker-integration", then click "Create new API key".
Generating API key
IMPORTANT: Your API key is automatically copied to your clipboard once it's created. You won't be able to view it later, so please save it somewhere secure now.
Information required for the Coworker connection:
auth_token
: The personal API key you generated earlierstart_date
: Date of the first record to synchronize, in a ISO8601 format (eg.2024-01-01
)workspace_name
: Workspace identifier, used in your workspace URL (ie.linear.app/[my-workspace]
->my-workspace
)
ℹ You must share your token and credentials via a secure app like 1Password or LastPass. This is for SOC2 compliance and to protect your data