Skip to content

Task Set Tags

Replace a native task's complete structured tag and namespace set. Namespace spelling is independent of registered project associations; this operation does not change project links.

Skill name: task_set_tags

Category: tasks

Mutates state (retry policy: verify_first)

Parameters

Name Type Required Description
client_mutation_id str No Optional stable idempotency key.
expected_revision int No Current task revision for compare-and-swap; the gateway pins it when omitted.
namespace_tags list[str] Yes Complete replacement set, with every supplied entry stored as a namespace (no leading '#'). Existing ordinary tags are also replaced; use the dashboard's separate tag/namespace fields when that distinction must be preserved. A projects/ prefix has no special project-link meaning. An empty list strips tags while preserving project associations.
task_id str Yes Task ID (e.g., 't-xxxxxxxx')