Skip to main content
Create a single tag. The command takes one required flag, --name, and returns the new tag’s ID. Use the ID in subsequent tag attach calls when you want to attach the same tag to many channels or events without rediscovering it by name. Tag names are not unique in TalkValue, so creating the same name twice produces two distinct tags. Use tag list --name <substring> before creating if you want to reuse an existing tag.

Synopsis

Options

Examples

1. Create a single tag

Prints the new tag as a single-record table: ID and name.

2. Capture the ID for the rest of the script

Use this pattern when you need to attach the same tag to several known sources in one go.

3. Bulk-create from a list

Reads names line by line, prints each new id\tname pair. Pair with tee tag-ids.txt to keep the mapping for later attach steps.

Response

The shape matches every other tag response in the API. Re-use the id when scripting many attaches.

See also