Überwachung

Ereignistypen eines Kontos wählen

PATCH /v1/monitor/targets/{target} targets:write

Ändert, welche Ereignistypen für ein überwachtes Konto (oder eines, das noch aufgelöst wird) zugestellt werden. Die Auswahl gilt für Stream, Webhooks und GET /v1/events gleichermaßen; erweitern Sie sie wieder, kommen die hinzugefügten Typen ab diesem Moment an. Eine offene Verbindung übernimmt die Änderung bei ihrer nächsten Aktualisierung. Senden Sie If-Match mit dem ETag des Detail-Endpunkts, um keine gleichzeitige Änderung zu überschreiben. Alle wählbaren Typen und häufige Kombinationen: Ereignistypen wählen. {target} bezeichnet das Konto: seine Nutzer-ID, sein aktuelles Handle oder ein früheres Handle.

Request-Body

Body-Feld	Typ	Bedeutung
`event_types` *	string[] \| null	Die zuzustellenden Ereignistypen, aus `GET /v1/meta/event-types`; `null` oder `[]` für alle

Antwort

200 mit dem aktualisierten Target (oder der ausstehenden Form); 400 invalid_request mit unbekannten Typen in details.unknown; 404 not_subscribed; 412, wenn If-Match veraltet ist. Feld für Feld: Ziel.

Status: 200, 400, 404, 412

Anfrage

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"]}'

Antwort · 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
  }
}