Component schema

LinearLabelAddedAgenticWorkflowTriggerSpec

object1 direct reference

Definition

object

stringrequired

The Linear label UUID that must be added to an issue for the trigger to fire. This is the sole matching key — matched case-insensitively against the label ID reported on the webhook event. If a label is re-created in Linear (new UUID, same name), update this field to re-point the trigger at the new label.

string

Optional Linear label name corresponding to labelId, stored for UI display and exposed to prompts as the linear.label.name template variable. Does not participate in matching — the trigger fires on labelId only, so a same-named label in a different team never hijacks a trigger scoped to a specific label. Clients that already know the name at write time (the workflow editor, Terraform authors) should send it so the workflow-list view renders a human-readable label; programmatic API callers may omit it and get a UUID-only display until the field is populated.

string[]

List of Linear team UUIDs to scope the trigger to. When non-empty, the trigger fires only for issues whose team ID is in this list. Mutually exclusive with allTeams; a request that sets both, or that leaves both teamIds and allTeams empty/unset, is rejected on write as an accidental match-everything catch-all.

boolean

When true, the automation deliberately matches the configured label added to issues in every team of the connected Linear workspace, now and in the future. Mutually exclusive with a non-empty teamIds list. This flag exists to distinguish an explicit "all teams" choice from an unconfigured trigger: a Linear label-added trigger with neither allTeams nor teamIds set is rejected on write as an accidental match-everything catch-all, mirroring allOrganizations on GitHub triggers.

LinearLabelAddedTriggerVariableName[]read only

The trigger-specific variables available as {{variable.name}} when this trigger fires. This is in addition to the built-in variables that are always available.

Used by 1

These schemas and endpoints reference this type directly.

SchemaLinearLabelAddedAgenticWorkflowTrigger

json

OpenAPI source1234567891011121314151617181920212223242526272829303132333435
{
  "type": "object",
  "properties": {
    "labelId": {
      "description": "The Linear label UUID that must be added to an issue for the trigger to fire. This is\nthe sole matching key — matched case-insensitively against the label ID reported on\nthe webhook event. If a label is re-created in Linear (new UUID, same name), update\nthis field to re-point the trigger at the new label.\n",
      "type": "string"
    },
    "labelName": {
      "description": "Optional Linear label name corresponding to `labelId`, stored for UI display and\nexposed to prompts as the `linear.label.name` template variable. Does not\nparticipate in matching — the trigger fires on `labelId` only, so a same-named\nlabel in a different team never hijacks a trigger scoped to a specific label.\nClients that already know the name at write time (the workflow editor, Terraform\nauthors) should send it so the workflow-list view renders a human-readable label;\nprogrammatic API callers may omit it and get a UUID-only display until the field is\npopulated.\n",
      "type": "string"
    },
    "teamIds": {
      "description": "List of Linear team UUIDs to scope the trigger to. When non-empty, the trigger fires\nonly for issues whose team ID is in this list. Mutually exclusive with `allTeams`; a\nrequest that sets both, or that leaves both `teamIds` and `allTeams` empty/unset, is\nrejected on write as an accidental match-everything catch-all.\n",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "allTeams": {
      "description": "When true, the automation deliberately matches the configured label added to issues\nin every team of the connected Linear workspace, now and in the future. Mutually\nexclusive with a non-empty `teamIds` list. This flag exists to distinguish an\nexplicit \"all teams\" choice from an unconfigured trigger: a Linear label-added\ntrigger with neither `allTeams` nor `teamIds` set is rejected on write as an\naccidental match-everything catch-all, mirroring `allOrganizations` on GitHub\ntriggers.\n",
      "type": "boolean"
    },
    "availableVariables": {
      "description": "The trigger-specific variables available as `{{variable.name}}` when this trigger fires.\nThis is in addition to the built-in variables that are always available.\n",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LinearLabelAddedTriggerVariableName"
      },
      "readOnly": true
    }
  },
  "required": [
    "labelId"
  ]
}