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

1
async () => Object.keys(spec.paths).filter((path) => path.startsWith('/settings'))

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.

1234567
async () => {
  const response = await cavuno.request({
    method: 'GET',
    path: '/settings/job-form',
  });
  return response.data;
}

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.