모니터링

계정의 이벤트 타입 선택

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

모니터링 중인 계정(또는 아직 확인 중인 계정)에 대해 전달할 이벤트 타입을 바꿉니다. 선택은 스트림, 웹훅, 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
  }
}