aboutsummaryrefslogtreecommitdiffstats
path: root/docs/MESHBAY_HTTP_API.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/MESHBAY_HTTP_API.md')
-rw-r--r--docs/MESHBAY_HTTP_API.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/MESHBAY_HTTP_API.md b/docs/MESHBAY_HTTP_API.md
index 74b9d77..1bcb55d 100644
--- a/docs/MESHBAY_HTTP_API.md
+++ b/docs/MESHBAY_HTTP_API.md
@@ -180,6 +180,14 @@ hub also serves the web application at `/` and `/app/`, which are not listed.
| DELETE | `/v1/notifications` | user or node | Throw them all away. |
| POST | `/v1/notifications/read-all` | user or node | Dismiss every one — the same thing as `DELETE ""`, under the name an older client knows it by. |
+### Push
+
+| Method | Path | Auth | What |
+|---|---|---|---|
+| POST | `/v1/push/subscriptions` | user | Register this phone, or update its row: with an endpoint and keys when it has a push distributor, without them when it will fetch instead. |
+| POST | `/v1/push/poll` | none | What is new for this phone since `since`: the same payloads a push carries, oldest first, at most twenty. |
+| DELETE | `/v1/push/subscriptions/{subscription_id}` | user | Stop telling one phone anything: turned off there, or signed out of. |
+
## Node control API
`http://127.0.0.1:<ui_port>`, port 18000 unless `ui_port` in `node.toml` says