# Company rules for apps and keys

> Company owners decide who in the company may connect an app or make an API key, and whether keys may change jobs. The rules are checked on every call.

- Source: https://greenhired.com/developers/api/v1/company-rules/
- Section: GreenHired developers · API · Job seekers and employers
- Last updated: 2026-11-21

## The two rules

A personal key and a connected AI app act with the permissions of the person who made them, inside the company. So a company owner sets two rules, on the page **Company, then Connected app** ([`/recruit/company/connected-app`](https://greenhired.com/recruit/company/connected-app)):

| Rule | Options | Default |
| --- | --- | --- |
| Who may connect an app or make an API key | Nobody. Owners only. Owners and HR managers. Everyone who works on hiring (owners, HR managers and recruiters) | Owners and HR managers. Plain team members never may |
| Let API keys create and change our jobs | On or off | Off |

Only a company owner can change them. Everyone else sees the page read-only.

## They apply on every call

The rules are checked each time a key or an app makes a request, not only when it is made. So changes take effect at once, and nobody has to remove anything by hand:

- Tightening "who may connect" stops the keys and apps of people who are no longer included, immediately.
- Switching off job changes stops writes from every key of the company, immediately. Reading still works.
- A person who is demoted, removed from the company or waiting for approval loses their keys with their role.
- A suspended company, or a company that requires two-factor sign-in when the person has not turned it on, stops all of its keys and apps.

## What owners can see and do

- Owners see every member's connected apps and personal keys, with today's requests, and can remove any of them.
- Every rule change is written to the audit log with the old and the new value.
- GreenHired admins can also remove a key or an app, or switch off job changes for a company, with a reason in the admin audit log.

| What you see | Meaning |
| --- | --- |
| `403 blocked_by_company` | Your company's rule does not include your role. Ask an owner |
| `403 job_writes_off` | Job changes are switched off for the company. Ask an owner |
| `403 no_company` | The account has no active company, or its request to join is still waiting for approval |
| `403 mfa_required` | The company requires two-factor sign-in and you have not turned it on |

## Frequently asked questions

**Why can my teammate not make a key?**

The default lets only owners and HR managers. A company owner can include recruiters by choosing "Everyone who works on hiring". Plain team members can never connect an app or make a key.

**Does this also apply to AI assistants?**

Yes. The "who may connect" rule applies to connected AI apps as well as personal keys, on every call. The job-changes switch only matters for keys, because assistants can never change jobs.

**If I switch job changes off, do keys stop working?**

Only the writes stop. Keys can still read your company and jobs. Switch it on again and writes resume, with no new key needed.

## Related pages

- https://greenhired.com/developers/api/v1/employer-jobs/
- https://greenhired.com/developers/api/v1/employers/
- https://greenhired.com/developers/mcp/security/
