Companies

Find, create, update, delete, and inspect the companies that supply jobs to your job board.

Companies are the employer records behind jobs and public company pages. Resolve a company before creating its jobs so you do not create duplicate employer records.

Discover company operations

javascript

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

Find or create a company

javascript

1async () => {
2  const response = await cavuno.request({
3    method: 'POST',
4    path: '/companies/find-or-create',
5    body: { name: 'Acme', website: 'https://acme.com' },
6  });
7  return response.data;
8}

Avoid duplicate companies

Search by website domain and normalized name before creating a record. The find-or-create operation matches the website domain first and then the company name; it does not search a company-alias field. A company cannot be merged through the Operator API. Treat permanent deletion as a destructive operation: show the affected jobs first, obtain approval, then confirm the company no longer exists.

The canBackfill field is informational—it reports whether Cavuno’s behind-the-scenes managed import may support the company. MCP cannot initiate or configure that managed import. To build your own import, have the AI client or code read the source and use MCP, the CLI, or the REST API for the Cavuno records.

Company blocklist

When an employer must leave the board, block them so backfill, import, and bulk API writes cannot reintroduce jobs. Pass remove: true to also remove the profile and its jobs from the board while keeping the company blocked. Without it, live published jobs are archived and the profile stays. Unblock does not republish archived jobs.

javascript

1async () => {
2  const blocked = await cavuno.request({
3    method: 'POST',
4    path: `/companies/${companyId}/block`,
5    body: { reason: 'legal request', remove: true },
6  });
7  return blocked.data; // { id, blocked: true, removed: true, removal_scheduled: true, ... }
8}

Deleting a blocked company with DELETE /companies/:id keeps it blocked and removes it from the board. Unblock first to delete it completely.

javascript

1async () => {
2  const unblocked = await cavuno.request({
3    method: 'POST',
4    path: `/companies/${companyId}/unblock`,
5  });
6  return unblocked.data;
7}

See Company blocklist.