sazabi tasks

sazabi tasks — Manage tasks and automatic task creation rules in connected trackers. Subcommands: create, comment, transition, rules, mapping.

`sazabi tasks`

Manage tasks and automatic task creation rules in connected trackers

sazabi tasks <subcommand>

sazabi tasks create --container ENG --title "Fix login bug"  # Create a task in the ENG tracker
sazabi tasks rules list  # List automatic task creation rules
sazabi tasks mapping set --provider linear --resolved "Done"  # Map Resolved to a Linear state
sazabi tasks rules create --connection-id <id> --provider linear --container-id ENG --min-severity high  # Create a routing rule
sazabi tasks comment --task-id ENG-123 --body-markdown "Fixed in the latest deploy"  # Add a comment to a task
sazabi tasks transition --task-id ENG-123 --state Done  # Move a task to a target state

`sazabi tasks create`

Create a task such as a Linear issue

sazabi tasks create [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--container`	string	No	Container id, short key (e.g. a Linear team key like ENG), or display name
`--title`	string	No	Task title
`--body-markdown`	string	No	Markdown body/description for the task
`--state`	string	No	Optional initial workflow state, by name or state ref
`--item-type`	string	No	Task type, by name or type ref (required only for trackers that declare types)
`--client-request-id`	string	No	Stable idempotency key. Pass the same value when retrying a create so a lost/timed-out response does not file a duplicate task

sazabi tasks create --container ENG --title "Fix login bug"  # Create a task in the ENG tracker
sazabi tasks create --container ENG --title "Fix login bug" --body-markdown "Steps to repro..." --json  # Create with a body and print JSON
sazabi tasks create --container ENG --title "Fix login bug" --client-request-id "$(uuidgen)"  # Safe to retry with the same key

`sazabi tasks comment`

Add a comment to a task

sazabi tasks comment [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--task-id`	string	No	The task to comment on: its provider-native id or human identifier (e.g. "ENG-123")
`--body-markdown`	string	No	Markdown body of the comment

sazabi tasks comment --task-id ENG-123 --body-markdown "Fixed in the latest deploy"  # Add a comment to a task

`sazabi tasks transition`

Move a task to a target workflow state

sazabi tasks transition [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--task-id`	string	No	The task to transition: its provider-native id or human identifier (e.g. "ENG-123")
`--state`	string	No	Target workflow state, by name (case-insensitive) or state ref

sazabi tasks transition --task-id ENG-123 --state Done  # Move a task to a target state

`sazabi tasks rules`

Manage automatic task creation rules for a project

sazabi tasks rules <subcommand>

`sazabi tasks rules list`

List task creation rules

sazabi tasks rules list [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--project-id`	string	No	Override active project ID

sazabi tasks rules list  # List all rules in priority order
sazabi tasks rules list --json  # Output rules as JSON

`sazabi tasks rules get`

Get a task creation rule by ID

sazabi tasks rules get <rule-id> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--project-id`	string	No	Override active project ID
`--rule-id`	string	No	Rule ID (UUID)

sazabi tasks rules get <rule-id>  # View details of a rule

`sazabi tasks rules create`

Create an automatic task creation rule

sazabi tasks rules create [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--project-id`	string	No	Override active project ID
`--connection-id`	string	No	Integration connection ID (Linear, Jira or GitHub connection)
`--provider`	string	No	Task provider (linear, jira, github)
`--container-id`	string	No	Container ID (Linear team ID, Jira project ID or key, or GitHub repository as owner/repo)
`--min-severity`	string	No	Minimum issue severity to match (low, medium, high, critical)
`--component-ids`	string	No	Comma-separated component UUIDs to match (repeatable via commas; exclusive with --team-ids)
`--team-ids`	string	No	Comma-separated owning-team UUIDs to match (exclusive with --component-ids)
`--default-item-type`	string	No	Default task item type (required for Jira)
`--default-state`	string	No	Default workflow state in external tracker
`--priority`	string	No	Evaluation priority order (lower numbers evaluated first)
`--enabled`	boolean	No	Enable the rule (default: true)
`--disabled`	boolean	No	Create rule in disabled state

sazabi tasks rules create --connection-id <id> --provider linear --container-id ENG --min-severity high  # Route high/critical issues to Linear ENG
sazabi tasks rules create --connection-id <id> --provider jira --container-id PROJ --default-item-type Bug  # Route issues to Jira PROJ as Bug
sazabi tasks rules create --connection-id <id> --provider github --container-id acme/api  # Route issues to GitHub Issues in acme/api

`sazabi tasks rules update`

Update an automatic task creation rule

sazabi tasks rules update <rule-id> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--project-id`	string	No	Override active project ID
`--rule-id`	string	No	Rule ID (UUID)
`--connection-id`	string	No	New integration connection ID
`--provider`	string	No	New task provider (linear, jira, github)
`--container-id`	string	No	New container ID
`--min-severity`	string	No	New minimum issue severity (or 'all' to match all severities)
`--clear-min-severity`	boolean	No	Clear minimum severity threshold to match all severities
`--component-ids`	string	No	Comma-separated component UUIDs to match (or empty string to clear; exclusive with --team-ids)
`--clear-components`	boolean	No	Clear component filter so the rule matches all components
`--team-ids`	string	No	Comma-separated owning-team UUIDs to match (or empty string to clear; exclusive with --component-ids)
`--clear-teams`	boolean	No	Clear team filter so the rule matches all teams
`--default-item-type`	string	No	New default task item type
`--default-state`	string	No	New default workflow state
`--priority`	string	No	New evaluation priority order
`--enabled`	string	No	Enable or disable rule (true/false)

sazabi tasks rules update <rule-id> --min-severity critical  # Raise severity threshold
sazabi tasks rules update <rule-id> --enabled false  # Disable a rule

`sazabi tasks rules delete`

Delete an automatic task creation rule

sazabi tasks rules delete <rule-id> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--project-id`	string	No	Override active project ID
`--rule-id`	string	No	Rule ID (UUID)

sazabi tasks rules delete <rule-id>  # Delete a task creation rule

`sazabi tasks rules reorder`

Reorder task creation rules by priority

sazabi tasks rules reorder <rule-ids...> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--project-id`	string	No	Override active project ID

sazabi tasks rules reorder <id1> <id2> <id3>  # Reorder rules (first is evaluated first)

`sazabi tasks mapping`

Map Sazabi issue statuses to a task tracker's states

sazabi tasks mapping <subcommand>

sazabi tasks mapping get  # Show the mapping for the one connected tracker
sazabi tasks mapping set --resolved "Done" --ignored "Canceled"  # Pick two rows

`sazabi tasks mapping get`

Show the toggle and the mapped states

sazabi tasks mapping get [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--provider`	string	No	Task tracker (linear, jira, github). Optional while one tracker with status mapping is connected
`--connection-id`	string	No	The tracker connection to act on; defaults to the organization's live connection. GitHub may have one per installation.

sazabi tasks mapping get --provider linear  # Show the toggle and the four rows

`sazabi tasks mapping set`

Turn status mapping on or off and pick a row's state

sazabi tasks mapping set [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--provider`	string	No	Task tracker (linear, jira, github). Optional while one tracker with status mapping is connected
`--connection-id`	string	No	The tracker connection to act on; defaults to the organization's live connection. GitHub may have one per installation.
`--enabled`	boolean	No	Turn status mapping on
`--disabled`	boolean	No	Turn status mapping off
`--open`	string	No	State for Open, by name, or none to empty the row
`--resolved`	string	No	State for Resolved, by name, or none to empty the row
`--ignored`	string	No	State for Ignored (and Rejected), by name, or none to empty the row
`--resolved-resolution`	string	No	Jira only: resolution a Resolved move closes with, by name, or none for the default done one. Takes effect only while Resolved maps to a done-type status
`--ignored-resolution`	string	No	Jira only: resolution an Ignored (and Rejected) move closes with, by name, or none for the first canceling one

sazabi tasks mapping set --provider linear --enabled  # Turn it on, rows unchanged
sazabi tasks mapping set --provider linear --resolved "Done"  # Map Resolved to Done
sazabi tasks mapping set --provider linear --ignored none  # Empty the Ignored row
sazabi tasks mapping set --provider jira --resolved "Done" --resolved-resolution "Fixed"  # Close resolved issues as Done / Fixed
sazabi tasks mapping set --provider jira --ignored "Done" --ignored-resolution "Won't Do"  # Close ignored issues as Done / Won't Do
sazabi tasks mapping set --provider github --enabled  # Turn it on; GitHub's rows come prefilled
sazabi tasks mapping set --provider github --connection-id <id> --enabled  # One of several GitHub installations

`sazabi tasks mapping states`

List the tracker states a row may take

sazabi tasks mapping states [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--organization-id`	string	No	Override active organization ID
`--provider`	string	No	Task tracker (linear, jira, github). Optional while one tracker with status mapping is connected
`--connection-id`	string	No	The tracker connection to act on; defaults to the organization's live connection. GitHub may have one per installation.

sazabi tasks mapping states --provider linear  # The default team's states and their types
sazabi tasks mapping states --provider jira  # The default project's statuses and the site's resolutions
sazabi tasks mapping states --provider github  # The three GitHub Issue states: open, closed as completed, closed as not planned

On this page