generated: '2026-07-15'
method: generated
source: openapi/employment-hero-openapi.yml
description: Recommended x-agentic-access execution contracts, classified heuristically from
  the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind
  audience per deployment. See research/curity/agentic-governance/.
summary:
  operations: 24
  by_action_class:
    connected: 15
    acting: 9
  by_consequence:
    read: 15
    write: 9
  human_in_the_loop_required: 0
operations:
- path: /api/v1/organisations/{organisation_id}/employees
  method: get
  operationId: listEmployees
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/employees/{id}
  method: get
  operationId: getEmployee
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/employees/quick_add_employee
  method: post
  operationId: quickAddEmployee
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v2/organisations/{organisation_id}/employees/{employee_id}/bank_accounts
  method: get
  operationId: getEmployeeBankAccounts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/certifications
  method: get
  operationId: listCertifications
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/certifications
  method: post
  operationId: createCertification
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/certifications/{certification_id}
  method: get
  operationId: getCertification
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/certifications/{certification_id}
  method: patch
  operationId: updateCertification
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/certifications/{certification_id}
  method: delete
  operationId: deleteCertification
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/certifications/polling_status
  method: get
  operationId: certificationPollingStatus
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/certifications/{certification_id}/archive_status
  method: patch
  operationId: certificationArchiveStatus
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/certifications/file_uploads
  method: post
  operationId: uploadCertificationFile
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/employees/{employee_id}/job_histories
  method: get
  operationId: getJobHistories
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/cost_centres
  method: get
  operationId: listCostCentres
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/custom_fields
  method: get
  operationId: listCustomFields
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/forms
  method: get
  operationId: listForms
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/forms/{form_id}
  method: get
  operationId: getForm
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/forms/{form_id}/responses
  method: get
  operationId: listFormResponses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/forms/{form_id}/responses/{response_id}
  method: get
  operationId: getFormResponse
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/departments
  method: post
  operationId: createDepartment
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/departments/{department_id}
  method: patch
  operationId: updateDepartment
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/employees/{employee_id}/documents
  method: get
  operationId: listEmployeeDocuments
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/organisations/{organisation_id}/employees/{employee_id}/documents
  method: post
  operationId: uploadEmployeeDocument
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/organisations/{organisation_id}/employees/{employee_id}/emergency_contacts
  method: get
  operationId: listEmergencyContacts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none