Skip to main content
This event occurs when there is activity on a Linear issue, such as creation, editing, or state changes. 
@on("linear.issues")
def agent(input):
    pass
The following is an example payload which is passed in as an argument to your agent’s entrypoint: 
{
    "action": "create",
    "issue": {
        "id": "47d4ba46-0f09-4216-97d8-350bb0bfc99f",
        "number": 14,
        "title": "Remove secrets from logs",
        "description": "During log processing, the same way we remove \"/#/\" log lines, we need to remove blocks secrets that are registered. Use the global and local environment variable / secret fetching logic we have and only mask secrets.",
        "priority": 0,
        "priorityLabel": "No priority",
        "state": {
            "id": "bfce67a7-30df-414a-a7d5-6a879f40d79e",
            "name": "Todo",
            "type": "unstarted",
            "color": "#e2e2e2"
        },
        "team": {
            "id": "8a193230-9912-4df9-ac1c-b712c36e9ca8",
            "key": "BLO",
            "name": "BlocksOrg"
        },
        "creator": {
            "id": "95e51d16-13d4-481e-bac9-9b0d6ef528ee",
            "name": "dev@blocks.team",
            "email": "dev@blocks.team"
        },
        "labels": [],
        "url": "https://linear.app/blocksorg/issue/BLO-14/remove-secrets-from-logs",
        "identifier": "BLO-14",
        "createdAt": "2025-06-04T03:17:18.674Z",
        "updatedAt": "2025-06-04T17:52:00.525Z"
    },
    "organization": {
        "id": "695d139f-6da4-46e0-a4ad-e6e5ba163b5a"
    },
}

​
Fields

​
action
string
The action that occurred on the issue.
​
issue
object
The issue that the event is on.
​
organization
string
The orgnaization associated with the Linear project.