-
-
Notifications
You must be signed in to change notification settings - Fork 0
Integrations
github-actions[bot] edited this page May 5, 2025
·
3 revisions
Lasius allows you to automatically generate tags in a project based on issues from external issue tracking systems.
ℹ️ Note that configuration settings are currently stored in the database. However, there is an open issue to integrate configuration management directly into the application. Until then, please note that changes to the configuration in the database require a manual restart of the Lasius backend service.
Lasius integrates with Plane, allowing you to retrieve issues from Plane.
To set up this integration, you need to add an entry to the PlaneConfig table with the following JSON schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Auto generated id from mongodb"
},
"name": {
"type": "string"
},
"baseUrl": {
"type": "string",
"description": "Base url of plane instance."
},
"auth": {
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Long-living API Key to access issues and projects"
}
},
"required": [
"apiKey"
]
},
"settings": {
"type": "object",
"properties": {
"checkFrequency": {
"type": "integer",
"description": "Interval in millis to check for new issues"
}
},
"required": [
"checkFrequency"
]
},
"projects": {
"type": "array",
"description": "Map lasius projects to projects in plane",
"items": [
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"description": "Lasius project id"
},
"settings": {
"type": "object",
"properties": {
"planeWorkspace": {
"type": "string",
},
"planeProjectId": {
"type": "string"
},
"params": {
"type": "string",
"description": "Additional search query params to add"
},
"maxResults": {
"type": "integer",
"description": "Max issues to query at once, defaults to 100 (limit of plane)."
},
"tagConfiguration": {
"type": "object",
"properties": {
"useLabels": {
"type": "boolean",
"description": "True if plane labels should be added booking entry as sub-tags"
},
"labelFilter": {
"type": "array",
"description": "Labels part of this array will be not be added as tags",
"items": [
{
"type": "string"
}
]
},
"useTitle": {
"type": "boolean",
"description": "If true, use issue title as tag",
},
"includeOnlyIssuesWithState": {
"type": "array",
"description": "Include only issues in state in the results",
"items": {
"type": "string"
}
},
"includeOnlyIssuesWithLabels": {
"type": "array",
"description": "Include only issues having a certain label in the results",
"items": {
"type": "string"
}
}
},
"required": [
"useLabels",
"labelFilter"
]
}
},
"required": [
"planeWorkspace",
"planeProjectId",
"tagConfiguration"
]
}
},
"required": [
"projectId",
"settings"
]
}
]
}
},
"required": [
"_id",
"name",
"baseUrl",
"auth",
"settings",
"projects"
]As an example:
db.PlaneConfig.insertOne({
"name" : "Plane Integration",
"baseUrl" : "https://myplane.instance.com",
"auth" : {
"apiKey" : "1234"
},
"settings" : {
"checkFrequency" : 60000
},
"projects" : [
{
"projectId" : "97e0ea08-7342-4f50-be76-2d1fd0849172",
"settings" : {
"planeWorkspace" : "my-plane-workspalce",
"planeProjectId" : "004e182a-5117-45eb-ad06-7c37a9f83170",
"maxResults" : 1000,
"tagConfiguration" : {
"useLabels" : true,
"labelFilter" : [
"Infrastructure",
],
"useMilestone" : false,
"useTitle" : false,
"includeOnlyIssuesWithState" : [
"Backlog",
"Todo",
"In Progress"
],
"includeOnlyIssuesWithLabels" : [ ]
}
}
}
]
})
Lasius integrates with Gitlab, allowing you to retrieve issues from both Gitlab's SaaS offering and self-hosted Gitlab instances.
To configure this integration, you'll need to add an entry to the GitlabConfig table with the following JSON schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"_id": {
"type": "string",
"description": "Auto generated id from mongodb"
},
"name": {
"type": "string"
},
"baseUrl": {
"type": "string"
},
"auth": {
"type": "object",
"properties": {
"accessToken": {
"type": "string",
"description": "Long living accesstoken to the linked gitlab project"
}
},
"required": ["accessToken"]
},
"settings": {
"type": "object",
"properties": {
"checkFrequency": {
"type": "integer",
"description": "Interval in millis to check for new issues"
}
},
"required": ["checkFrequency"]
},
"projects": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"descrption": "Lasius project id to map parsed tags to"
},
"settings": {
"type": "object",
"properties": {
"gitlabProjectId": {
"type": "string",
"description": "Gitlab project id"
},
"projectKeyPrefix": {
"type": "string",
"description": "Prefix appended to gitlab project key when creating tag (i.e. GL_#130)",
"example": "GL_"
},
"params": {
"type": "string",
"description": "Additional search query params to add"
},
"maxResults": {
"type": "integer",
"description": "Max issues to query at once, defaults to 100 (limit of plane)."
},
"tagConfiguration": {
"type": "object",
"properties": {
"useLabels": {
"type": "boolean",
"description": "True if plane labels should be added booking entry as sub-tags"
},
"labelFilter": {
"type": "array",
"description": "Only add labels of the provided array as tags if assigned to the issue",
"items": [
{
"type": "string"
}
]
},
"useMilestone": {
"type": "boolean",
"description": "If true, add milestone name as tag"
},
"useTitle": {
"type": "boolean",
"description": "If true, add issue title as tag"
}
},
"required": [
"useLabels",
"labelFilter",
"useMilestone",
"useTitle"
]
}
},
"required": ["gitlabProjectId", "tagConfiguration"]
}
},
"required": ["projectId", "settings"]
}
]
}
},
"required": ["_id", "name", "baseUrl", "auth", "settings", "projects"]
}As an example:
db.GitlabConfig.insertOne({
"_id" : "63031f5b6dbea8d2c0ae47ed",
"name" : "Gitlab Project1",
"baseUrl" : "https://gitlab.com/api/v4/",
"auth" : {
"privateKey" : "",
"accessToken" : "My-Access-Token",
"consumerKey" : ""
},
"settings" : {
"checkFrequency" : 60000
},
"projects" : [
{
"projectId" : "01cf9ba6-683a-4a89-a8c1-d0a7d970def6",
"settings" : {
"gitlabProjectId" : "111",
"projectKeyPrefix" : "GL_",
"tagConfiguration" : {
"useLabels" : true,
"labelFilter" : [
"Doing",
"Open"
],
"useMilestone" : true,
"useTitle" : true
}
}
}
]
})
ℹ️ Warning: The Jira integration uses a deprecated API version and must be updated before use to ensure compatibility.