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

talkvalue path tag attach <sourceId> --tag-id <id>
talkvalue path tag attach <sourceId> --name <name>

​
Arguments

ArgumentTypeDescription
<sourceId>integerChannel ID or event ID to attach the tag to. TalkValue detects whether the ID is a channel or an event automatically.

​
Options

FlagTypeDescription
--tag-id <id>integerAttach an existing tag by ID. Find IDs with tag list or capture them when you tag create.
--name <name>stringAttach by name. If no tag with that name exists, TalkValue creates one and attaches it in the same request.

​
Examples

​
1. Attach an existing tag by ID

talkvalue path tag attach 7 --tag-id 42
Adds tag 42 to channel (or event) 7. The response prints the tag as confirmation the write succeeded.

​
2. Create-or-attach by name

talkvalue path tag attach 18 --name "Customer Day 2026"
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

tag_id=42
for channel_id in 7 12 18 21; do
  talkvalue path tag attach "$channel_id" --tag-id "$tag_id"
done
Re-uses one ID across the loop. Attaching a tag is idempotent, so re-running the loop after a partial failure is safe.

​
Response

{
  "data": {
    "id": 42,
    "name": "LinkedIn"
  }
}
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