Linear
Connect a Linear workspace
BackupLatte connects to Linear through Linear's OAuth: you approve access on Linear's own page, and BackupLatte never sees your Linear password. One BackupLatte account can connect any number of workspaces; each is backed up on its own schedule.
Connect
- In Linear, select the workspace you intend to connect.
- In BackupLatte, open Dashboard -> Add platform and choose Connect Linear. If Linear is already connected, use Open workspaces on its Dashboard card, then Connect another workspace.
- Linear shows the access BackupLatte asks for. Check that the workspace named there is the right one, then choose Authorize.
- Return to BackupLatte and check the next scheduled time. Eligible backups are queued by the scheduler; completion depends on workspace size, API availability and the queue.
Linear always shows the approval screen, even for a workspace you connected before, so you can see which workspace is being connected every time.
Which Linear account to connect with
A backup collects supported datasets visible to the connecting Linear user. Private teams that user is not a member of are not included, and neither are other people's personal items. Connect as a workspace admin who is a member of every team you want backed up. Extended coverage needs an admin in any case.
Access BackupLatte asks for
| Access | Why |
|---|---|
read | To back up the workspace. |
write | Only for restores you start: creating the restored records in Linear. |
admin | Only with extended coverage: reading the audit log, invitations, workspace settings, integrations and webhooks. |
The access tokens Linear issues are stored encrypted (AES-256-GCM). Linear access tokens expire after about a day; BackupLatte checks them before use and refreshes them when expired or close to expiry.
Extended coverage
Some workspace data is only readable with Linear's admin access: the audit log, pending invitations, workspace settings, integrations and webhooks. BackupLatte never stores the credentials, webhook URLs or secrets of integrations and webhooks.
To turn it on:
- Open the workspace in BackupLatte, tick Extended coverage in Settings and choose Save settings.
- Choose Reconnect with admin access and approve the new access in Linear, as a Linear admin.
Until Linear grants admin access, backups carry on without these sets and list them as gaps.
Several workspaces
Choose Open workspaces on the Linear Dashboard card. Each connection appears with its own schedule, retention and backups. Search by name or key, filter by connection status or by how the last backup went, and switch between tiles and a table.
All active connected Linear workspaces count toward the Linear plan: see Plans and billing.
Reconnect
A workspace you disconnected, or whose access Linear revoked (for example, someone removed the app in Linear's settings), shows Reconnect at the top of its page. Open that workspace in Linear first — Linear connects the workspace open in your browser — then choose Reconnect and approve it with the same Linear account. The workspace is active again with fresh access, and its existing backups stay. If Linear connected a different workspace, the app says so: switch workspaces in Linear and choose Reconnect again.
Disconnect and delete
In the workspace's Settings:
- Disconnect stops scheduled backups and deletes BackupLatte's copy of the Linear access token. Jobs still queued for the workspace are marked failed. Existing snapshots stay until retention deletes them, and can still be downloaded — and restored into another connected workspace. You can reconnect at any time.
- Delete workspace removes the workspace with every backup and restore record, and its stored files through background cleanup. This cannot be undone. See Deleting your data.
You can also remove BackupLatte from Linear itself, in Linear's settings under the applications you have authorised; its backups then fail until you reconnect it.
Something missing or unclear? Write to [email protected].