Modomation — API endpoints

Base domain

• https://modomation.streamercatalyst.com

The StreamerCatalyst dashboard calls the session endpoints same-origin through https://streamercatalyst.com/m/modomation/* (for example /m/modomation/api/channels/:id/config reaches /api/channels/:id/config here). That proxy forwards the session cookie over a Cloudflare service binding and never forwards /internal/*.

Endpoints

Path	Method	Auth	Description
/api/channels/:id/config	GET/PUT	Session cookie	Per-channel Modomation configuration.
/api/channels/:id/channel-rewards	GET	Session cookie	The channel’s Twitch channel-point rewards, for rule pickers.
/api/channels/:id/rules	GET/POST	Session cookie	Channel-point redemption automation rules.
/api/channels/:id/rules/:ruleId	PUT/DELETE	Session cookie	Update or delete a redemption rule.
/api/channels/:id/redemption-tracking	GET/PUT	Session cookie	Redemption tracking settings; …/tracked-rewards (GET/POST, DELETE …/:rewardId) picks the rewards to track.
/api/channels/:id/redemption-counts	GET	Session cookie	Per-viewer counts for a tracked reward; …/redemption-leaderboard ranks them.
/api/channels/:id/event-rules	GET/POST	Session cookie	Channel event automation rules (stream online/offline, raids, etc.).
/api/channels/:id/event-rules/:ruleId	PUT/DELETE	Session cookie	Update or delete a channel event rule.
/api/channels/:id/vip-config	GET/PUT	Session cookie	VIP automation settings.
/api/channels/:id/vips	GET/POST	Session cookie	VIP grants; DELETE …/vips/:userId revokes one and GET …/vip-audit is the history.
/api/channels/:id/auto-shoutout-config	GET/PUT	Session cookie	Auto-shoutout settings.
/api/channels/:id/auto-shoutout-users	GET/POST	Session cookie	Who gets an auto-shoutout; PUT/DELETE …/auto-shoutout-users/:userId edits or removes one.
/api/channels/:id/ml-capture-config	GET/PUT	Session cookie	Whether moderation activity is captured for ML suggestions.
/api/channels/:id/ml-suggestions	GET	Session cookie	ML-generated AutoMod suggestions; POST …/:suggestionId/dismiss, /snooze or /restore acts on one.
/internal/eventsub	POST	Service binding (internal)	EventSub fan-out receiver (internal).
/internal/billing/downgrade	POST	Service binding (internal)	Tier-downgrade handler (internal).

Auth model

• Session cookie endpoints require an active StreamerCatalyst session (set at login via the platform Worker). A channel-scoped route (/api/channels/:id/…) answers only for the session’s own channel, and a read-only admin masquerade may read but not change anything.
• Service binding endpoints are for other StreamerCatalyst Workers, called over Cloudflare service bindings with a shared internal token. They are not a public API.