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.
On this page
#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):
| 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.
Was this page helpful?