Monitorización

Elegir tipos de evento de una cuenta

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

Cambia qué tipos de evento se entregan para una cuenta que monitorizas, o para una que aún se está resolviendo. La elección se aplica por igual al stream, a los webhooks y a GET /v1/events; si la vuelves a ampliar, los tipos añadidos te llegan desde ese momento. Una conexión abierta recoge el cambio en su siguiente actualización. Envía If-Match con el ETag del endpoint de detalle para no sobrescribir un cambio simultáneo. Todos los tipos que puedes elegir y combinaciones habituales: Elegir tipos de evento. {target} indica la cuenta: su id de usuario, su nombre de usuario actual o uno que tuvo antes.

Cuerpo de la solicitud

Campo del cuerpo	Tipo	Significado
`event_types` *	string[] \| null	Los tipos de evento a entregar, de `GET /v1/meta/event-types`; `null` o `[]` para todos

respuesta

200 con el Target actualizado (o la forma pendiente); 400 invalid_request con los tipos desconocidos en details.unknown; 404 not_subscribed; 412 cuando If-Match está desactualizado. Campo por campo: Objetivo.

Estado: 200, 400, 404, 412

solicitud

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

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