Authentication
What API keys and connected apps can see
On this page
Bizisy treats every API key and every connected AI app as a machine. A machine acts as its person, with their role, but it gets less than that person does in the web app: other people's private and pay data never leave Bizisy through a machine, and a few actions stay with a person signed in to Bizisy.
These rules are checked by the server on every call, the same way for REST and MCP and for keys and connected apps. They don't depend on the client.
Other people's private and pay data#
Each field of a person has a visibility tier: public, job, private or pay.
| Tier | A person in the web app | A machine |
|---|---|---|
| Public (name, work email, title, team, photo) | Everyone in the company | The same |
| Job (job details and history, contract terms) | The person, their managers, owners, admins and HR | The same |
| Private (personal contact details, address, birthday, emergency contacts, payroll identifiers) | The person, owners, admins and HR | Only the person's own |
| Pay | The person, owners, admins and HR | Only the person's own |
So an HR Manage key reading someone else gets their public and job tiers: private fields come back null and private custom fields are left out (visible_tiers says which tiers you got). The same key reading its own person gets everything. Webhook payloads follow the same rule.
Files follow it too: through a machine, other people's documents come as metadata only and never download, and someone else's file in a custom field shows its size and type, not its name.
Actions that stay in the web app#
Some actions are refused for every machine, whatever the role. They hand out secrets, move money or switch off a safeguard, so a person signed in to Bizisy does them:
| Action | Why |
|---|---|
platform.roles.create | Roles are created in the app only, so an assistant can never widen anyone's access. |
platform.roles.update | Roles are changed in the app only. |
platform.roles.delete | Roles are deleted in the app only. |
platform.members.set_access_until | An outsider's end date is changed in the app only. |
platform.me.two_step | Two-step sign-in is managed in the Bizisy app (My profile → Two-step sign-in). |
platform.me.two_step.changed | Two-step sign-in is managed in the Bizisy app (My profile → Two-step sign-in). |
platform.push.subscribe | Push notifications are turned on in a browser or the installed app. |
platform.credits.checkout | Credit packs are bought on Stripe's page in the browser, by owners and admins signed in to Bizisy. |
platform.storage.limit.set | The storage limit is raised or lowered in the app only (Settings → Plan & billing), by an owner or admin. |
platform.features.update | Modules and AI and API access are switched in the app only (Settings → Modules), by an owner or admin. |
platform.promotions.redeem | Promotion codes are redeemed in the app only, by an owner or admin. |
platform.ai_addendum.request | Asking owners to accept the AI features addendum is done in the Bizisy app. |
platform.dpa.accept | The data processing agreement is accepted in the app only, by an owner. |
platform.billing.checkout | Payment pages open in the browser, for owners and admins signed in to Bizisy. |
platform.billing.portal | Payment pages open in the browser, for owners and admins signed in to Bizisy. |
platform.billing.invoices.pdf | Invoices download in the browser, for owners and admins signed in to Bizisy. |
platform.billing.pay | Invoices are paid on Stripe's page in the browser, by owners and admins signed in to Bizisy. |
org.pay.add | Pay is recorded in the app only. |
org.pay.remove | Pay is changed in the app only. |
org.pay.import | Pay history is imported in the app only. |
org.health_checks.record | Health-check dates are changed by owners, admins and HR signed in to Bizisy (or a role allowed sensitive details). |
org.health_checks.set_due | Health-check dates are changed by owners, admins and HR signed in to Bizisy (or a role allowed sensitive details). |
org.one_on_ones.setup_team | A manager sets up their team's 1:1s in the Bizisy app. |
org.one_on_ones.start_meeting | The two people hold the meeting in the Bizisy app. |
org.one_on_ones.finish | The two people wrap up the meeting in the Bizisy app. |
org.one_on_ones.health | HR reads 1:1 health in the Bizisy app. |
org.one_on_ones.nudge_managers | HR asks or reminds managers from the Bizisy app. |
org.one_on_ones.exemption_request | Exemptions carry a justification: asked for in the Bizisy app. |
org.one_on_ones.exemption_decide | Exemptions are decided in the Bizisy app. |
org.one_on_ones.exemption_close | Withdrawn or ended in the Bizisy app. |
org.announcements.publish | Publishing stays in the Bizisy app; machines may draft. |
org.announcements.acknowledge | Each person confirms in the Bizisy app or at the time clock kiosk. |
org.positions.approval_rule.update | Who approves new positions is set in the app only, so an assistant can never switch approval off. |
org.positions.decide | Approving a position needs a person signed in to Bizisy. |
org.approvals.settings.update | Who approves changes is set in the app only, so an assistant can never switch approval off. |
org.approvals.approve | Approving needs a person signed in to Bizisy. |
org.approvals.reject | Rejecting needs a person signed in to Bizisy. |
org.titles.settings.update | Who may add job titles is set in the app only, so an assistant can never widen it. |
org.pay_bands.list | Pay bands are pay data: read in the app only. |
org.pay_bands.set | Pay bands are set in the app only. |
org.pay_bands.remove | Pay bands are changed in the app only. |
org.title_evaluations.approve | Approving evaluations needs a person signed in to Bizisy. |
org.pay_categories.set | Categories of workers are set in the app only. |
org.pay_categories.remove | Categories of workers are changed in the app only. |
org.pay_equity.settings.update | Pay equity settings are changed in the app only. |
org.pay_equity.overview | The pay gap is pay data: read in the app only. |
org.pay_reports.list | Pay gap reports are pay data: read in the app only. |
org.pay_reports.get | Pay gap reports are pay data: read in the app only. |
org.pay_reports.create | Pay gap reports are made in the app only. |
org.pay_reports.upload_variable | Variable pay is uploaded in the app only. |
org.pay_reports.components | How pay items count in a report is chosen in the app only. |
org.pay_reports.justify | Pay gaps are justified in the app only. |
org.pay_reports.finalise | Pay gap reports are finalised in the app only. |
org.pay_reports.mark_submitted | Submissions are recorded in the app only. |
org.pay_reports.remove | Pay gap reports are deleted in the app only. |
org.pay_reports.export | Pay gap reports are exported in the app only. |
org.pay_requests.list | People's pay requests are pay data: read in the app only. |
org.pay_requests.reply | Pay requests are answered in the app only. |
org.pay_requests.record | Requests received on paper are recorded in the app only. |
org.pay_equity.reminder_status | Who was reminded of the right to ask about pay is read in the app only. |
org.access.preview_person | Previewing a role is for owners and admins signed in to Bizisy. |
org.outsiders.invite | Outside access is given in the app only. |
org.directory.connect | An owner or admin connects a directory in the app (Integrations → Google Workspace or Microsoft 365 → Directory sync). |
org.directory.disconnect | Disconnecting happens in the app. |
org.directory.settings.update | Directory sync settings change in the app only. |
org.directory.import | The one-time import runs in the app. |
org.directory.link | Linking a person to an account happens in the app. |
org.directory.exclude | Excluding someone from directory sync happens in the app. |
org.directory.confirm | A person confirms new and reactivated accounts in the app. |
org.directory.retry | Retrying a failed change happens in the app. |
org.directory.reveal_password | A first password is shown only in the app, once. |
org.chat.connect | An owner or admin connects a chat tool in the app (Integrations, Chat: Slack, Microsoft Teams, Google Chat, Mattermost, Discord or Rocket.Chat). |
org.chat.settings.update | The channel and what is announced change in the app only. |
org.chat.test | Test messages are sent from the app. |
org.chat.skip | Skipping an announcement happens in the app. |
org.chat.retry | Trying a failed announcement again happens in the app. |
org.chat.disconnect | Disconnecting happens in the app. |
org.spend.start | An owner or admin starts syncing a spend tool in the app, after reviewing the plan. |
org.spend.confirm | A person confirms invites and card blocks in the app. |
org.spend.exclude | Excluding someone from a spend tool sync happens in the app. |
org.spend.retry | Retrying a failed change happens in the app. |
org.learning.choose | A person confirms or excludes people for a learning platform in the app (Integrations → the platform → People). |
org.scim.tokens.create | An owner or admin creates SCIM tokens in the app (Integrations → SCIM): a token is never made with a key. |
org.scim.tokens.revoke | Revoking a SCIM token happens in the app. |
org.okta.confirm | A person confirms new, reactivated and held Okta account changes in the app. |
org.okta.exclude | Keeping someone out of Okta provisioning happens in the app. |
org.okta.retry | Retrying a failed Okta change happens in the app. |
org.ats.hires.accept | HR adds a hire from a recruiting tool in the app. |
org.ats.hires.link | Linking a hire to someone already in Bizisy happens in the app. |
org.ats.hires.dismiss | Dismissing a hire happens in the app. |
org.bank.request | Bank accounts change in the app only (Verified bank details). |
org.bank.proof.start | Bank accounts change in the app only (Verified bank details). |
org.bank.proof.finish | Bank accounts change in the app only (Verified bank details). |
org.bank.decide | Bank accounts change in the app only (Verified bank details). |
org.bank.cancel | Bank accounts change in the app only (Verified bank details). |
org.bank.get | Bank accounts change in the app only (Verified bank details). |
org.bank.changes.list | Bank accounts change in the app only (Verified bank details). |
org.bank.proof_url | Bank accounts change in the app only (Verified bank details). |
org.bank.settings.get | Bank accounts change in the app only (Verified bank details). |
org.bank.settings.update | Bank accounts change in the app only (Verified bank details). |
org.planning.items | Names people with future last days: owners, admins and HR in the Bizisy app. |
org.planning.scenarios.adopt | Adopting a scenario changes the budget: in the Bizisy app. |
data.feed.token_create | An owner or admin creates the BI token in the app (Integrations → Power BI and Excel → Access): it is shown once there. |
data.feed.token_revoke | Revoking the BI token happens in the app. |
data.pay.set | Sharing pay with data tools is a person's choice in the app (Integrations → Power BI and Excel → Access), recorded in Activity. |
documents.signatures.upload_signed.start | Signed copies are uploaded by HR in the app. |
documents.signatures.upload_signed.finish | Signed copies are uploaded by HR in the app. |
documents.me.signatures.upload_signed.start | People upload what they signed in the app. |
documents.me.signatures.upload_signed.finish | People upload what they signed in the app. |
documents.templates.settings.update | Who approves templates is set by owners and admins in the app. |
documents.templates.decide | A person approves template versions in the app (Approvals). |
documents.me.accept | Accepting a document is done by the person in the app. |
documents.consent.set | Consent to electronic documents is recorded by HR or the person in the app. |
documents.me.consent.set | The person agrees in the app, signed in themselves. |
documents.prepared.get | Opening a prepared document (its preview holds pay and private details) is done in the app. |
documents.me.statement.request | The person asks in the app, signed in themselves. |
documents.me.policies.acknowledge | The person acknowledges a policy in the app, signed in themselves. |
documents.me.declarations.request | The person asks in the app, signed in themselves. |
payroll.schedules.set | Pay schedules and the bank account are set in the app only. |
payroll.sepa.create | The SEPA salary file is made in the app only. |
payroll.consents.grant | Only a person signed in to Bizisy lets a machine receive pay data. |
payroll.consents.revoke | Consents are revoked in the app only. |
payroll.payslips.download | Unmatched payslips are opened in the app only. |
payroll.push.send | Sending a pay period to a payroll tool happens in the app only. |
timeoff.requests.decide | Approving or declining time off needs a person signed in to Bizisy. |
timeoff.feeds.create | Calendar feeds are created in the app only (the result is a private link). |
timeclock.corrections.decide | Deciding or confirming a time correction needs a person signed in to Bizisy. |
timeclock.corrections.apply_anyway | Applying a disputed correction needs HR signed in to Bizisy. |
timeclock.months.reopen | Reopening a closed month needs HR signed in to Bizisy. |
timeclock.months.acknowledge | People acknowledge their month in the app only. |
timeclock.pin.set | A kiosk PIN is set by the person in the app only. |
timeclock.kiosks.create | Kiosks are set up in the app only (the result is a one-time device link). |
timeclock.overtime.decide | Approving or declining overtime needs a person signed in to Bizisy. |
timeclock.overtime.settle | Approving overtime already worked (or marking it not overtime) needs a person signed in to Bizisy. |
timeclock.terminals.create | Terminals are added in the app only (the result holds the terminal's one-time server address). |
timeclock.terminals.rotate | A new terminal address is made in the app only (it is shown once). |
shifts.week.publish | A person publishes a rota in the app: it tells people and has legal effect. A dry run is not offered either. |
shifts.requests.approve | An editor approves shift requests in the app. |
shifts.requests.decline | An editor declines shift requests in the app. |
shifts.feeds.create | Calendar feed links are created in the app (the link is a secret). |
hiring.settings.update | Hiring settings change in the app only (Settings → Hiring): they include the referral bonus. |
hiring.jobs.preview_page | Live previews of a job's page show in the app only (Hiring → the job → Job post); machines read the job with hiring.jobs.get. |
hiring.settings.preview_page | Live previews of the careers page show in the app only (Settings → Hiring). |
hiring.settings.preview_email | Previews of the emails to candidates show in the app only (Settings → Hiring → Candidates). |
hiring.applications.move | Moving candidates happens in the app: a person decides. |
hiring.applications.reject | "Not this time" is decided in the app: a person decides, never an AI. |
hiring.applications.cancel_reject | Taking back a "not this time" happens in the app. |
hiring.applications.message | Writing to candidates happens in the app; machines may draft the text. |
hiring.applications.add | Adding a candidate (it emails them) happens in the app. |
hiring.referrals.create | Referring someone (it emails them) happens in the app. |
hiring.referrals.mark_paid | Referral bonuses are marked paid in the app only. |
hiring.candidates.erase | Erasing a candidate happens in the app only. |
hiring.candidates.export | A candidate's data export happens in the app only. |
hiring.interviews.book | Booking an interview (it emails the candidate and the interviewers) happens in the app. |
hiring.interviews.offer | Offering interview times (it emails the candidate) happens in the app. |
hiring.interviews.reschedule | Moving an interview (it emails everyone) happens in the app. |
hiring.interviews.cancel | Cancelling an interview (it emails everyone) happens in the app. |
hiring.interviews.no_show | A no-show is recorded in the app. |
hiring.feedback.save | Feedback is written by the interviewer in the app. |
hiring.feedback.submit | Feedback is sent by the interviewer in the app. |
hiring.feedback.add_note | Corrections to feedback are added by its author in the app. |
hiring.me.interviews | An interviewer's own interviews are read in the app (My workspace → Interviewing). |
hiring.me.interview | Interview kits (the candidate's CV and answers) are for the interviewer in the app. |
hiring.contribution.thank | Saying thanks (it emails people) happens in the app. |
hiring.offers.draft | Offers are made in the app; machines may suggest the terms. |
hiring.offers.update | Offers are changed in the app. |
hiring.offers.submit | Offers are checked and sent for approval in the app. |
hiring.offers.decide | Offers are approved in the app: a person decides. |
hiring.offers.send | Sending an offer (it emails the candidate) happens in the app. |
hiring.offers.withdraw | Withdrawing an offer (it emails the candidate) happens in the app. |
hiring.offers.revise | Revising an offer (it emails the candidate) happens in the app. |
hiring.letters.update | Offer letters change in the app only (Settings → Hiring → Offer letters); machines may draft the text. |
hiring.letters.reset | Offer letters change in the app only. |
hiring.handoff.apply | The handoff after a hire (a buddy, the first 1:1, closing the job with replies) is finished in the app. |
hiring.internal.apply | People apply for jobs inside the company themselves, in My workspace; an AI never applies for them. |
hiring.internal.withdraw | The person withdraws in My workspace. |
hiring.internal.cv_upload_url | The person uploads their CV in My workspace when they apply. |
hiring.offers.accept_internal | The person accepts their offer in My workspace. |
hiring.offers.decline_internal | The person declines their offer in My workspace. |
hiring.offers.finish_transfer | HR finishes an internal move in the Bizisy app. |
training.me.report | The person reports their own training in the app. |
training.certificates.upload | Certificates are uploaded in the app. |
training.certificates.download | Certificates are private: they are downloaded in the app. |
surveys.me.save | A person answers in the app. |
surveys.me.submit | A person answers in the app. |
surveys.council.request | HR asks the works council in the app. |
surveys.council.decide | The works council decides in the app. |
surveys.public.set | A public link is switched on in the app, where its rules are shown. |
talent.cycles.preview_email | Previews of the review cycle emails show in the app only (Talent → Performance → Preview emails). |
talent.reviews.get | Reviews (answers, ratings, feedback) are read in the app only. |
talent.reviews.answer | Reviews are written in the app only. |
talent.reviews.submit | Reviews are submitted in the app only. |
talent.reviews.signoff | Sign-off happens in the app only. |
talent.reviews.send_back | Sending back happens in the app only. |
talent.feedback.nominations | Who gives feedback is shown in the app only. |
talent.feedback.nominate | People choose their peers in the app only. |
talent.feedback.decide | Managers approve peers in the app only. |
talent.feedback.mine | Feedback requests are answered in the app only. |
talent.feedback.answer | Feedback is given in the app only. |
talent.feedback.decline | Declining happens in the app only. |
talent.goals.suggest_status | Whether goal suggestions can be asked for is read in the app only. |
talent.goals.suggest_measures | AI suggestions of measures for a goal are asked for in the app only (an AI calling an AI would spend credits). |
talent.cycles.sex_check | Ratings by sex are checked in the app only. |
comp.cycles.get | A cycle's setup, budgets and progress hold pay: read in the app only. |
comp.cycles.create | Salary reviews are set up in the app only. |
comp.cycles.update | Salary reviews are set up in the app only. |
comp.cycles.publish_criteria | Criteria are published to staff in the app only. |
comp.cycles.launch | A salary review is launched in the app only. |
comp.cycles.step | Large launches and releases continue in the app (or by the sweep). |
comp.cycles.cancel | A salary review is cancelled in the app only. |
comp.cycles.release_now | A salary review is released in the app only: it writes pay and sends letters. |
comp.cycles.export | The payroll file holds pay: exported in the app only. |
comp.worksheet.get | A manager's worksheet is read in the app only. |
comp.worksheet.save | Proposals are made in the app only. |
comp.worksheet.submit | Worksheets are submitted in the app only. |
comp.worksheet.amounts | Pay on a worksheet shows in the app only. |
comp.upper.get | Team worksheets are checked in the app only. |
comp.upper.save | Team worksheets are checked in the app only. |
comp.upper.submit | Team worksheets are checked in the app only. |
comp.upper.return | Team worksheets are checked in the app only. |
comp.signoff.get | The final sign-off holds pay totals: in the app only. |
comp.cycles.sign_off | Salary reviews are signed off in the app only. |
comp.cycles.send_back | Salary reviews are sent back in the app only. |
comp.review.get | HR reviews proposals in the app only. |
comp.review.decide | Proposals are approved in the app only. |
comp.review.edit | HR changes proposals in the app only. |
comp.review.return | Worksheets are sent back in the app only. |
comp.review.refresh | Rows are refreshed in the app only. |
comp.review.skip | Rows are skipped in the app only. |
comp.review.equity | The equity check is read in the app only. |
comp.review.mark_paid | Lump sums are marked paid in the app only. |
comp.review.rating_check | Ratings and raises by sex are checked in the app only. |
comp.letters.mine | Letters hold pay: read in the app only. |
comp.letters.get | Letters hold pay: read in the app only. |
comp.bonus.plans.get | A plan's formula, totals and payouts hold pay: read in the app only. |
comp.bonus.plans.create | Bonus plans are set up in the app only. |
comp.bonus.plans.update | Bonus plans are set up in the app only. |
comp.bonus.plans.publish_formula | The formula is published to staff in the app only. |
comp.bonus.plans.launch | A bonus plan is launched in the app only. |
comp.bonus.plans.step | Large launches and releases continue in the app (or by the sweep). |
comp.bonus.plans.cancel | A bonus plan is cancelled in the app only. |
comp.bonus.plans.release_now | A bonus plan is released in the app only: it pays and sends letters. |
comp.bonus.awards.list | Awards hold pay: read in the app only. |
comp.bonus.awards.adjust | Awards are adjusted in the app only. |
comp.bonus.awards.decide | Awards are approved in the app only. |
comp.bonus.equity | The equal-pay check is read in the app only. |
comp.bonus.awards.mark_paid | Awards are marked paid in the app only. |
insights.settings.update | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.notice.send | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.problems.report | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.people.list | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.people.get | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.reviews.record | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.recompute | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.exclusions.list | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.exclusions.set | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.explanations.list | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.explanations.reply | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.me.object | An objection is the person's own click in My workspace. |
insights.me.explanation.ask | Asking for an explanation is the person's own click in My workspace. |
insights.audit.list | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.audit.export | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.checks.bias.run | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.checks.list | Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight). |
insights.checks.backtest.run | The back-test runs in the Bizisy app, by a person (EU AI Act human oversight). |
insights.checks.backtest.acknowledge | An owner or admin acknowledges the back-test in the app only. |
insights.checks.backtest.get | Back-test results are read in the app only. |
migration.resume | A move in the background is resumed by a person signed in to Bizisy. |
migration.undo | Undoing a move needs a person signed in to Bizisy. |
migration.exports.preview | Moving to another tool happens in the Bizisy web app. |
migration.exports.start | Moving to another tool happens in the Bizisy web app. |
migration.exports.get | Moving to another tool happens in the Bizisy web app. |
migration.exports.list | Moving to another tool happens in the Bizisy web app. |
migration.exports.download | Moving to another tool happens in the Bizisy web app. |
migration.exports.remove | Moving to another tool happens in the Bizisy web app. |
webhooks.endpoints.create | Endpoints are added in the app only (the result is a secret, and data starts flowing to a new place). |
webhooks.endpoints.delete | Endpoints are deleted in the app only. |
webhooks.endpoints.roll_secret | Secrets are rolled in the app only (the result is a secret). |
accounting.journals.list | Headcount-cost journals carry pay totals: they are read in the app only. |
accounting.journals.get | Headcount-cost journals carry pay totals: they are read in the app only. |
accounting.journals.prepare | HR prepares a journal from pay in the app only (pay consent, P11). |
accounting.journals.approve | Approving a journal needs a person signed in to Bizisy. |
accounting.journals.discard | Discarding a journal happens in the app. |
integrations.connections.connect | An owner or admin connects a tool in the app (Integrations): credentials and access grants never pass through a key. |
integrations.connections.update | A connection's settings and its events secret change in the app only. |
integrations.connections.disconnect | Disconnecting happens in the app. |
country.notices.prepare | A notice's data (NISS, date of birth, pay) is private: it is prepared in the app. |
country.notices.submit | HR reviews and sends a notice to Segurança Social in the app. |
country.credentials.set | Segurança Social access is entered by an owner or admin in the app. |
country.credentials.clear | Segurança Social access is removed in the app. |
country.relatorio_unico.generate | The Relatório Único files hold private and pay data: they are made in the app. |
country.relatorio_unico.annual.set | The yearly forms name health and safety staff: they are saved in the app. |
country.relatorio_unico.providers.save | Service providers hold private identifiers: they are entered in the app. |
country.relatorio_unico.providers.remove | The service providers list is changed in the app. |
country.relatorio_unico.providers.import | Service providers hold private identifiers: they are imported in the app. |
The API reference marks them Web app only.
Actions with limits for machines#
These work for machines, with a limit:
| Action | For keys and apps |
|---|---|
platform.me.companies | Only the company the key or app belongs to. |
platform.connections.revoke | Only your own connections (owners and admins disconnect others in the app). |
platform.members.set_role | Built-in roles only: a custom role is given in the app. |
platform.activity.changes | Other people's pay and private values come back hidden (hidden: true, no values). |
platform.activity.about_person | Pay and private values come back hidden (hidden: true, no values). |
org.units.list | Private team custom fields are never returned. |
org.units.create | Private team custom fields are refused. |
org.units.update | Private team custom fields are refused and never returned. |
org.people.list | The HR filters legal_entity_id, joined_between and left_between are refused. |
org.people.get | Private fields only for yourself. |
org.people.hire | Payroll details (tax_id, social_security_number, iban) and sex are refused. |
org.people.update_profile | Payroll details (tax_id, social_security_number, iban) and sex are refused. |
org.me.update | Payroll details (tax_id, social_security_number, iban) are refused. |
org.setup.apply | Payroll details, sex and private custom fields (of people and teams) are refused. |
org.people.import_csv | Payroll details, sex and private custom fields are refused. |
org.invites.create | url is null: the sign-in link is only emailed to the person. |
org.invites.create_many | The sign-in links are only emailed to the people, never returned. |
org.people.invite | Each invite.url is null: the sign-in links are only emailed to the people. |
org.fields.update | confirm_expose_existing (widening a tier while people have values) is refused. |
org.pay.list | Only your own pay. |
org.people.export_csv | include_private is refused. |
org.people.export_data | Only for yourself (or use org.me.export_data). |
org.health_checks.list | Lists nobody unless the company allowed sensitive details for this key or app. |
org.check_ins.get | Only your own quarterly check-in. |
org.check_ins.answer | Only your own answers. |
org.check_ins.prepare | Only your own 1:1 and check-in. |
org.one_on_ones.get | Only your own 1:1 with your manager; a manager's side stays in Bizisy. |
org.one_on_ones.note | Only your own private note in your own 1:1. |
org.announcements.update | Drafts and scheduled ones only; a published announcement changes in the app. |
org.positions.list | pay_range (the budget) is never returned (pay_range_hidden is true). |
org.positions.create | pay_range and private custom fields are refused. |
org.positions.update | pay_range and private custom fields are refused. |
org.cases.list | Joiners missing payroll details (missing_details) are left out. |
org.changes.apply | Pay changes are refused: save the set with org.changes.draft and a person applies it in the app. |
org.changes.draft | Pay amounts are never returned. |
org.changes.list | Pay amounts are never returned. |
org.changes.get | Pay amounts are never returned. |
org.titles.create | Refused when the company lets only HR add job titles (org.titles.settings.update). |
org.pay_bands.position | Only your own band, and only when the company shows bands to people. |
org.title_evaluations.set | Drafts only (source "ai") for HR to approve; an approved evaluation is refused. |
org.drafts.save | Private details and pay are refused (the person adds them in the app). |
org.drafts.get | Private details and pay are left out. |
org.imports.start | CSV text of at most 250 people; files are imported in the app. |
org.imports.check | Payroll details, sex and private custom fields are refused; only runs the key or app started. |
org.imports.get | Payroll, sex and private cells of the sample rows are hidden. |
org.imports.rows | Payroll, sex and private cells are hidden. |
org.imports.apply | Only runs the key or app started. |
org.imports.fix_rows | Only runs the key or app started; payroll, sex and private cells are kept as they were. |
org.reports.overview | Pay and the gender split are null (pay_hidden, gender_hidden: apps): they are shown only in Bizisy. |
org.analytics.table | No gender, age band or custom-field dimensions; absence and regretted attrition only with rows "all" and no filter (hidden: apps); regretted cells never carry numerators. |
org.analytics.export | As the table: diversity tables, and absence or regretted by group, download in the Bizisy app only. |
org.groups.list | Groups with a private field are left out, and private fields never count for members. |
org.groups.update | A group a custom role uses decides whom the role covers: changing it needs an owner or admin signed in to Bizisy. |
org.ats.hires.list | Keys and connected apps see the hires without the candidate's personal email. |
org.planning.forecast | Headcount and FTE only: cost is left out (cost_hidden apps); the people behind a number are in the app. |
org.planning.scenarios.list | On-cost and cost per head are left out. |
org.planning.scenarios.get | On-cost and cost per head are left out. |
org.planning.scenarios.create | Drafts without on-cost or cost per head (refused if sent). |
org.planning.scenarios.update | On-cost and cost per head are refused if sent; what HR entered is kept. |
org.planning.scenarios.archive | On-cost and cost per head are left out of the result. |
org.planning.scenarios.restore | On-cost and cost per head are left out of the result. |
org.planning.scenarios.compare | Headcount and FTE only: cost is left out. |
org.planning.settings.get | The on-cost is left out. |
org.planning.settings.update | The on-cost is refused if sent. |
org.planning.export | Headcount and FTE columns only: no cost. |
documents.list | Other people's documents come as metadata only. |
documents.download | Other people's documents never download. |
documents.field_file.start | Other people's files are never returned. |
documents.signatures.list | Other people's signature requests come as ids and statuses, without signers' names. |
documents.templates.get | Templates with pay details come without their text. |
documents.templates.create | No templates with pay details. |
documents.templates.update | No templates with pay details. |
documents.templates.preview | Not for templates with pay details; private details only for the sample person. |
documents.templates.import_docx | No pay fields in the draft it makes. |
documents.generate | Only templates without private or pay details. |
documents.generated.list | Other people's documents come as metadata only. |
documents.export | Never other people's documents; no templates with pay details. |
documents.prepared.decide | Machines may discard; sending and editing are done in the app. |
documents.prepared.create | Through machines, the amendment never reads pay changes. |
payroll.periods.get | Pay and private values only with a consent (Payroll → Settings → Machine access); otherwise null and listed in withheld. |
payroll.items.import | Names people by person id or employee number only, unless a consent covers private data. |
payroll.exports.create | Needs a consent for pay and private data (Payroll → Settings → Machine access). |
payroll.exports.download | Needs a consent for pay and private data. |
payroll.net_pay.import | Needs a consent for pay data; names people by person id or employee number only, unless the consent covers private data. |
payroll.workspace | Only the company the key or app belongs to. |
payroll.payslips.start | Needs a consent for pay data. |
payroll.payslips.finish | Needs a consent for pay data. |
payroll.attachments.download | Needs a consent for pay and private data. |
payroll.push.preview | Pay values only with a consent (Payroll → Settings → Machine access); otherwise null. |
timeoff.book | Only for the key's or app's own person; booking for someone else needs a person signed in. |
timeoff.away.list | Other people's days come as "Away" only (dates and half days; never the type, note or status). |
timeclock.punch | Only for the key's or app's own person, at the current time (no offline clockings). |
timeclock.records.list | Other people's records only with the company's machine consent for private data; never locations. |
timeclock.corrections.request | Only for the key's or app's own person; correcting someone else needs a person signed in. |
timeclock.settings.update | Location, corrections, overtime approval and retention settings are changed in the app only. |
timeclock.overtime.request | Only for the key's or app's own person, when the company lets people ask for their own overtime. |
timeclock.overtime.list | Other people's overtime only with the company's machine consent for private data. |
timeclock.overtime.unapproved | Other people's days only with the company's machine consent for private data. |
timeclock.punches.ingest | Only owners', admins' and HR's API keys (a terminal's software), never connected AI apps or MCP; punches sent over 15 minutes late wait for the person's confirmation. |
shifts.week.history | Never the note of an "other" reason. |
shifts.requests.list | Never the private messages. |
shifts.my.availability.list | Never the private notes. |
shifts.my.availability.set | Notes are neither read nor written; existing notes are kept. |
shifts.settings.update | Rest rules as blocks and auto-approved claims are changed in the app. |
hiring.jobs.list | The pay range of a job never opened is hidden (salary_hidden). |
hiring.jobs.get | The pay range of a job never opened is hidden (salary_hidden). |
hiring.jobs.create | The pay range is copied from the position, and hidden in the result until the job is opened. |
hiring.jobs.update | Pay ranges (salary) and referral bonuses are set in the app only. |
hiring.jobs.close | Closing with reply_to_open (it emails candidates) happens in the app only. |
hiring.applications.get | No pay expectations, private notes or file links. |
hiring.applications.hire_draft | The pay suggestion is hidden; the hire itself happens in the app. |
hiring.referrals.list | Referral bonus amounts are hidden. |
hiring.offers.get | No pay, range, approver context or file links. |
hiring.offers.list | No pay. |
hiring.letters.preview | Sample terms only: previews of a real offer stay in the app. |
training.records.list | Never certificates or the reasons HR declined a report. |
training.records.get | Never certificates or the reasons HR declined a report. |
surveys.results.get | Groups under the survey's threshold are hidden, the same as in the app. |
surveys.results.responses | Named surveys only: a confidential survey never shows one person's answers to anyone, machines included. |
talent.settings.get | Without the works council checklist. |
talent.reviews.list | Statuses only (to do, done, left): never answers, ratings or who gave feedback. |
talent.goals.list | Company, team and shared goals only; never private personal goals. |
talent.goals.get | Company, team and shared goals only. |
talent.profile.get | Your own profile without certificate numbers; someone else's only when they show it to colleagues, as colleagues see it. |
talent.profile.entries.add | Certificate numbers (credential_id) are refused: the person adds them in the app. Someone else's profile only when it is shown to colleagues (otherwise not found). |
talent.profile.entries.update | Certificate numbers (credential_id) are refused; a stored number is kept as it is. Someone else's profile only when it is shown to colleagues. |
comp.cycles.list | Names, dates and stage only: never pay, people or proposals. |
comp.bonus.plans.list | Names, dates and status only: never pay, people or awards. |
migration.start | Pasted CSV of at most 250 people; files and API connections in Bizisy. |
migration.check | Pay, payroll identifiers, sex and private details are refused; only moves the key started. |
migration.items | Private and pay cells are hidden. |
migration.fix_items | Only moves the key started; private and pay cells are kept as they were. |
migration.import | At most 250 people, people only, inside the call; only moves the key started. |
webhooks.endpoints.list | Each url shows its host only (the path is often the receiver's secret). |
webhooks.endpoints.get | The url shows its host only. |
webhooks.endpoints.update | Only turning an endpoint off, its description and removing event types; a new URL, more events or turning it on happen in the app. The url in the result shows its host only. |
webhooks.subscriptions.create | For Zapier, Make and n8n over an API key; refused for AI assistants (MCP) and apps connected by signing in. |
webhooks.subscriptions.list | Each url shows its host only (the path is the receiver's secret). |
country.notices.list | Pay change notices (they reveal a pay change) are left out. |
country.facts.get | Person country data is left out. |
country.facts.set | Person country data (nationality, education level, place of birth) is refused; company codes are allowed. |
country.relatorio_unico.readiness | The records to fix come with their ids only, never names. |
country.relatorio_unico.annual.get | Without the names and numbers of health and safety staff and external services, and without work-accident counts. |
country.relatorio_unico.providers.list | Without a self-employed provider's NIF, NISS and name, or any NISS. |
Why#
- AI assistants act for people, they don't replace them. An assistant can prepare a change and preview it, but approving a change, recording pay or switching approvals off needs the person.
- A leaked key is bounded. A key that leaves your servers can't read anyone's bank details or home address, can't add a webhook that sends data somewhere new, and can't create more keys.
- Exports of private data happen in the app, where the person sees what they download.
Machines in Activity#
Everything a machine changes shows in Activity with the key's or the app's name. Through MCP, previews (dry runs) and failed attempts are recorded too, so you can see what an assistant tried, not only what it did.
Something missing or wrong on this page? Write to hello@bizisy.com.