Surveillance

Choisir les types d'événement d'un compte

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

Modifie les types d'événement livrés pour un compte que vous surveillez, ou pour un compte encore en cours de résolution. Le choix s'applique de la même façon au stream, aux webhooks et à GET /v1/events ; élargissez-le à nouveau et les types ajoutés vous parviennent à partir de ce moment. Une connexion ouverte prend en compte le changement à sa prochaine actualisation. Envoyez If-Match avec l'ETag de l'endpoint de détail pour ne pas écraser une modification simultanée. Tous les types possibles et les combinaisons courantes : Choisir les types d'événement. {target} désigne le compte : son identifiant, son nom d'utilisateur actuel ou un nom qu'il a eu avant.

Corps de la requête

Champ du corps	Type	Signification
`event_types` *	string[] \| null	Les types d'événement à livrer, issus de `GET /v1/meta/event-types` ; `null` ou `[]` pour tous

réponse

200 avec le Target mis à jour (ou la forme en attente) ; 400 invalid_request avec les types inconnus dans details.unknown ; 404 not_subscribed ; 412 quand If-Match est périmé. Champ par champ : Cible.

Statut: 200, 400, 404, 412

requête

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

réponse · 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
  }
}