Linear
Get the Linear connection
The team and project that receive the issues, and the webhook URL to register in Linear. The API key and the signing secret are never returned. 404 when Linear is not connected. Read only and safe to repeat.
Required scope: linear:read.
Headers
Lelemon-Subaccount^sub_[0-9A-Za-z]{22}…The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.
Get the Linear connection › Responses
objectidteamIdteamKeyteamNameprojectIdcreatedAtupdatedAtConnect Linear
Connects the Linear of your organization with a personal API key and chooses the team (and optionally the project) that receives the issues. Lelemon checks the key and the team with Linear before saving, and keeps the key encrypted. Connecting again replaces the key and the destination and keeps the webhook URL and the signing secret. Then create a webhook in Linear (Settings, API, Webhooks) with the Issues resource, the webhook URL of the answer, and send its signing secret with PATCH /v2/integrations/linear. 422 linear_rejected when Linear does not accept the key, the team or the project; 503 when Linear does not answer. Safe to repeat.
Required scope: linear:write.
Headers
Lelemon-Subaccount^sub_[0-9A-Za-z]{22}…The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.
Connect Linear › Request Body
apiKey^\S+$ · requiredA Linear personal API key. Create it in Linear, Settings, Account, Security and access. Use the key of a service user that can see the team. It is stored encrypted and never returned.
team^\S+$ · requiredThe key or the id of the Linear team that receives the issues.
project^\S+$The id of a project of that team. Without it the issues have no project.
Connect Linear › Responses
objectidteamIdteamKeyteamNameprojectIdcreatedAtupdatedAtDisconnect Linear
Deletes the key, the signing secret and the destination, and stops accepting notifications. The issues already created stay in Linear and the escalations stay in the cases. Repeating the call returns 404, because there is nothing left to disconnect.
Required scope: linear:write.
Headers
Lelemon-Subaccount^sub_[0-9A-Za-z]{22}…The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.
Disconnect Linear › Responses
Update the Linear connection
Changes only what you send: the API key, the team, the project, or the signing secret of the webhook. Saving the signing secret is what makes Lelemon accept the notifications of Linear. A new key or destination is checked with Linear first. 404 when Linear is not connected. Safe to repeat.
Required scope: linear:write.
Headers
Lelemon-Subaccount^sub_[0-9A-Za-z]{22}…The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.
Update the Linear connection › Request Body optional
apiKey^\S+$Replaces the API key.
team^\S+$Another team key or id.
project^\S+$Another project id. null removes it.
webhookSecret^\S+$The signing secret Linear shows when you create the webhook. It is stored encrypted and never returned.
Update the Linear connection › Responses
objectidteamIdteamKeyteamNameprojectIdcreatedAtupdatedAt