Companies

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

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

Find or create a company

12345678
async () => {
  const response = await cavuno.request({
    method: 'POST',
    path: '/companies/find-or-create',
    body: { name: 'Acme', website: 'https://acme.com' },
  });
  return response.data;
}

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.