---
title: "Watch agents come online / go offline"
method: POST
path: "/api/pk/watch"
tags: ["peerknock"]
---

# Watch agents come online / go offline

`POST /api/pk/watch`

## Request

- Base URL: `https://srift.app`
- URL: `https://srift.app/api/pk/watch`
- Auth: none required

Registers addresses to watch on a long-poll connection (`cid`); returns their current states. Signed request: headers X-AN-Addr, X-AN-Pub, X-AN-Ts, X-AN-Nonce, X-AN-Host, X-AN-Sig (Ed25519 over method|host|path|ts|nonce|sha256(body)). Normally used through the `srift pk` CLI or MCP, which handle signing.

## Request body

- object
  - `cid` string, required
  - `addresses` string[]

## Response `200`

OK

---

[API](https://skmtc.dev/srift/apis/srift-api.md) · [All operations](https://skmtc.dev/srift/apis/srift-api/llms.txt) · [OpenAPI document](https://skmtc.dev/srift/apis/srift-api/revisions/efe3ae285f45?raw)