Monitoramento

Escolher tipos de evento de uma conta

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

Altera quais tipos de evento são entregues para uma conta que você monitora, ou para uma ainda em resolução. A escolha vale igualmente para o stream, os webhooks e GET /v1/events; ao ampliar de novo, os tipos adicionados chegam a partir dali. Uma conexão aberta adota a mudança na próxima atualização. Envie If-Match com o ETag do endpoint de detalhe para não sobrescrever uma mudança simultânea. Todos os tipos que você pode escolher e combinações comuns: Escolher tipos de evento. {target} indica a conta: o id de usuário, o nome de usuário atual ou um que ela teve antes.

Corpo da requisição

Campo do corpo	Tipo	Significado
`event_types` *	string[] \| null	Os tipos de evento a entregar, de `GET /v1/meta/event-types`; `null` ou `[]` para todos

resposta

200 com o Target atualizado (ou o formato pendente); 400 invalid_request com os tipos desconhecidos em details.unknown; 404 not_subscribed; 412 quando If-Match está desatualizado. Campo a campo: Conta monitorada.

Status: 200, 400, 404, 412

requisição

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

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