Skip to main content
Attach a tag to a Path source. A source is either a channel ID or an event ID. The same command handles both, because the underlying tag relationship is shared. Pass --tag-id to attach an existing tag, or pass --name to attach an existing tag by name (and create one with that name if none exists). At least one of the two flags is required. If you pass both --tag-id and --name, pass only the one you want; supplying both has no defined precedence.

Synopsis

Arguments

Options

Examples

1. Attach an existing tag by ID

Adds tag 42 to channel (or event) 7. The response prints the tag as confirmation the write succeeded.

2. Create-or-attach by name

Convenient when scripting against a list of source IDs and a small handful of tag names. You do not need to look up or create tags upfront.

3. Bulk-attach the same tag to many channels

Re-uses one ID across the loop. Attaching a tag is idempotent, so re-running the loop after a partial failure is safe.

Response

Returns the tag that was attached. The source’s tag list (visible in channel get or event get) updates immediately and includes this tag on subsequent reads.

See also