What does "label watch" in the REST API do?

Confluence Development Confluence Cloud
,
1

Hi there,

I recently noticed the “Content watches” section in the REST API documentation, where I found the functionality to watch labels:

This is what I’ve done so far

  1. I created a label “foo” like this: Add labels for content. Prefix “global”
  2. I’ve added myself as watcher for label “foo”
  3. The label watch status returns true
  4. I’ve created / updated content with “foo” label (with another user!)
  5. But in the end: no notification… :x:

Do I misunderstand the feature? What is it for?
What should the labelName for watching look like? Is it just the name or does it consist of prefix and name (I tried both “foo” and “global:foo”)?

Thanks in advance!