Skip to main content
POST
Creates an empty group. Add tags to it with Create Tag.

Body

string
required
account, person or path. What the group’s tags label. Fixed once created: a tag cannot move between groups, and a group cannot change subject.
string
required
1-80 characters, unique for that subject type. A name already used by a group of the same subject type answers 409 CONFLICT.
string
default:"multi"
single holds at most one of the group’s tags per record, which is how a status behaves. multi holds any number.
A record type holds at most 20 groups, and a group at most 50 tags. Both return 422 rather than growing without limit: past a couple of dozen a flat picker stops being scannable, and what you want is another dimension rather than a hundredth tag.