Settings

Settings endpoints expose the configuration that controls how your job board behaves. Search the live specification for the relevant settings group rather than assuming one generic settings object.

Discover settings groups

Read the job form

The job form resource is read-only: the Operator API exposes GET /settings/job-form so an agent can discover custom field definitions before it creates or updates jobs. Board settings, AdSense, paywall, and password configuration have their own supported write operations.

Protect board-wide changes

Settings writes can affect every visitor or every new job. Return the current and proposed values as a diff, obtain approval, apply the narrowest supported patch, then re-fetch the same settings resource. Do not attempt to write to the read-only job form endpoint. Discover the live schema before promising a named setting: some additional values may exist inside the board configuration object rather than as dedicated endpoints.

Google's consent message for AdSense

GET /settings/adsense returns adsenseGoogleConsentMessage, which is true unless the owner turned it off. PUT /settings/adsense accepts it as an optional boolean. While AdSense is on, true makes visitors in the EEA, UK and Switzerland get Google's consent message instead of the board's cookie banner. The board context exposes the effective value as ads.googleConsentMessage, which is only true when AdSense is on with a valid publisher ID. The CLI equivalent is cavuno settings update-adsense --google-consent-message <true|false>. Before setting it to false, tell the owner to also turn off Maximize message coverage in AdSense; see Ads and consent.

Choose Apply country gating

countryGatingMode accepts exactly sponsored_only or all_jobs. Sponsored jobs are always country-gated; sponsored_only limits the additional check to Sponsored Apply actions, while all_jobs also checks ordinary external and native Apply actions on compatible starter boards.