API
구독 목록 조회
구독 페이지에 보이는 그대로, 메일함이 받는 뉴스레터와 메일링 리스트.
GET/subscriptions
워크스페이스에 실제 호출을 실행합니다.
GET /subscriptions
구독 페이지에 보이는 그대로, 메일함이 받는 뉴스레터와 메일링 리스트.
예시
threads:read가 필요합니다. 메일에 List-Unsubscribe 헤더가 붙은 발신자가 구독이며, 그 발신자가 메일을 보내는 주소마다 한 행이 있습니다. status는 기본값인 active 또는 unsubscribed이고, q는 발신자를 검색하며, sort는 recent, most, unread, name 중 하나입니다.
curl "$OE/subscriptions?sort=most&limit=1" -H "$AUTH"{ "object": "list", "data": [{ "object": "subscription", "id": "sub_5d2c8e17", "senderEmail": "[email protected]", "senderName": "Figma", "recipient": "[email protected]", "status": "active", "method": "one-click", "linkUrl": "https://www.figma.com/unsubscribe?u=4f1c", "unread": 12, "recent": 4, "total": 58, "sinceUnsubscribed": 0, "lastSeenAt": "2026-10-01T07:02:41.000Z", "unsubscribedAt": null, "unsubscribedWith": null, "future": null }], "total": 37, "counts": { "active": 37, "unsubscribed": 9 }, "hasMore": true}recent는 최근 30일의 메일을, sinceUnsubscribed는 구독을 해제한 뒤에도 들어온 메일을 세며, future는 새 메일을 계속 옮기는 규칙이 있으면 그 규칙을 가리킵니다.
limit(따로 정하지 않으면 50, 최대 200)과 offset으로 페이지를 넘깁니다. total은 일치하는 모든 행을 세고, counts는 구독 중인 것과 구독 해제된 것이 각각 몇 개인지 셉니다.
특정 주소로 제한된 키나 앱은 그 주소로 배달되는 구독만 나열하며, address는 이를 한 주소로 좁힙니다.