監視
アカウントのイベント種類を選ぶ
PATCH /v1/monitor/targets/{target} targets:write
監視中(または解決待ち)のアカウントについて、配信するイベント種類を変更します。選択はストリーム、Webhook、GET /v1/events のすべてに同じく適用されます。再び広げれば、追加した種類はその時点から届きます。開いている接続は次の更新で変更を取り込みます。同時の変更を上書きしないよう、詳細エンドポイントの ETag を If-Match で送ってください。選べる種類とよくある組み合わせはイベント種類の選択を参照してください。 {target} はアカウントを指します。ユーザー ID、現在のハンドル、または以前のハンドルを使えます。
リクエストボディ
| ボディのフィールド | 型 | 意味 |
|---|---|---|
event_types * | string[] | null | 配信するイベント種類(GET /v1/meta/event-types から)。null または [] ですべて |
レスポンス
200 で更新後の Target(または解決待ちの形)。400 invalid_request は未知の種類を details.unknown に示します。404 not_subscribed。If-Match が古ければ 412。 フィールドごとの説明: Target (監視対象).
ステータス: 200, 400, 404, 412
リクエスト
curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \ -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \ -d '{"event_types": ["tweet.create", "followers.verified.add"]}'
レスポンス · 200 / 400
{
"target": {
"id": "44196397",
"screen_name": "elonmusk",
"name": "Elon Musk",
"previous_screen_names": [],
"push_ready": true,
"last_push_at": "2026-09-16T08:12:03.417000+00:00",
"last_poll_at": "2026-09-16T08:12:10.002000+00:00",
"state": "subscribed",
"event_types": [
"tweet.create",
"followers.verified.add"
],
"event_types_all": false
}
}