= How to udpate the watch status of someone in dist-git

== How to see someone's watch status

There are two ways you can check this:

* Check the API
+
--
Visit https://src.fedoraproject.org/api/0/<namespace>/<name>/watchers

For example: https://src.fedoraproject.org/api/0/rpms/borgbackup/watchers

It will give you information about all the watchers and what they watch.
--

* Using pagure-admin
+
--
On the pagure host, run:
----
pagure-admin get-watch <namespace>/<name> <username>
----

For example:
----
pagure-admin get-watch rpms/borgbackup bpereto
----

It will return you the current watch status of that user on that project (or None if it is the
default status).
--

== How do you update status

* Using pagure-admin
+
--
On the pagure host, run:
----
pagure-admin update-watch <namespace>/<name> <username>
----
You will be prompted with options about which status to set, use `-1` to
revert to the default status.

Example:

----
# pagure-admin update-watch rpms/borgbackup bpereto
Using configuration file `/etc/pagure/pagure.cfg`
The watch status can be one of the following:
-1: reset the watch status to default
0: unwatch, don't notify the user of anything
1: watch issues and PRs
2: watch commits
3: watch issues, PRs and commits
Status:-1
Updating watch status of bpereto to -1 (reset the watch status to default) on rpms/borgbackup
----

--
