Set the survey frequency rule
Replace the workspace’s frequency rule. Send both day fields. 0 turns a person rule off. companyLimit is optional: send null to turn the Company limit off, or leave it out to keep it. The rule applies to email invitations and in-app sessions. It does not block responses you record through the API. Requires a secret server key (gt_live_). Publishable keys (gt_pub_) return 403.
Scope: write:surveys
Authorizations
Bearer API key. Secret server keys start with gt_live_; client-safe browser keys start with gt_pub_ (write-only, origin-pinned). Create and scope keys in Settings → API Keys.
Body
Days after any survey contact (email sent, in-app shown, answered, or imported answer) before the same person is surveyed again. 0 turns the rule off. Default 30.
0 <= x <= 365Days after someone dismisses an in-app survey before any in-app survey shows to them again. 0 turns the rule off. Default 7.
0 <= x <= 365Optional Company limit: ask at most people different people at one Company within days, across every survey and channel. People are matched by email address, so a person counts once however often they are asked, and reminders don't count. null means no limit, which is the default. Leave it out of a PUT to keep the saved limit.
Response
The saved rule.