Kota Agentic Access

generated: '2026-07-19'
method: generated
source: openapi/kota-api-reference-openapi.json, openapi/kota-openapi-original.json
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: 172
  by_action_class:
    connected: 99
    acting: 73
  by_consequence:
    read: 99
    write: 73
  human_in_the_loop_required: 0
operations:
- path: /employers
  method: get
  operationId: list-employers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employers
  method: post
  operationId: create-employer
  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: /employers/{employer_id}
  method: get
  operationId: retrieve-employer
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employers/{employer_id}
  method: put
  operationId: update-employer
  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: /employers/{employer_id}/offboard
  method: post
  operationId: offboard-employer
  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: /employees
  method: get
  operationId: list-employees
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees
  method: post
  operationId: create-employee
  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: /employees/{employee_id}
  method: get
  operationId: retrieve-employee
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}
  method: put
  operationId: update-employee
  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: /employees/{employee_id}/offboard
  method: post
  operationId: offboard-employee
  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: /employees/{employee_id}/offboard/cancel
  method: post
  operationId: cancel-offboarding-employee
  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: /employers/{employer_id}/health_insurance/quotes/{employer_quote_id}
  method: get
  operationId: retrieve-employer-health-insurance-quote
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employers/{employer_id}/health_insurance/quotes
  method: get
  operationId: list-employer-health-insurance-quotes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employers/{employer_id}/health_insurance/policies/{employer_policy_id}
  method: get
  operationId: retrieve-employer-health-insurance-policy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employers/{employer_id}/health_insurance/policies
  method: get
  operationId: list-employer-health-insurance-policies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/health_insurance/offers/{employee_offer_id}
  method: get
  operationId: retrieve-employee-health-insurance-offer
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/health_insurance/offers
  method: get
  operationId: list-employee-health-insurance-offers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/health_insurance/policies
  method: get
  operationId: list-employee-health-insurance-policies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/health_insurance/policies/{employee_policy_id}
  method: get
  operationId: retrieve-employee-health-insurance-policy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /requirements/{requirement_id}
  method: get
  operationId: get-requirement
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /requirements/{requirement_id}
  method: post
  operationId: submit-answers
  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: /contribution_reports/{contribution_report_id}
  method: get
  operationId: retrieve-contribution-report
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contribution_reports
  method: get
  operationId: list-contribution-reports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contribution_reports/{contribution_report_id}/finalize
  method: post
  operationId: finalize-contribution-report
  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: /contribution_reports/{contribution_report_id}/employee_breakdowns/{employee_id}
  method: get
  operationId: retrieve-employee-breakdown-for-contribution-report
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contribution_reports/{contribution_report_id}/employee_breakdowns
  method: get
  operationId: list-employee-breakdowns-for-contribution-report
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /events
  method: get
  operationId: list-events
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /events/{event_id}
  method: get
  operationId: retrieve-event
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /webhooks/endpoints
  method: get
  operationId: list-webhook-endpoints
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /webhooks/endpoints/{webhook_endpoint_id}
  method: get
  operationId: retrieve-webhook-endpoint
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /embed/sessions
  method: post
  operationId: create-embed-session
  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: /employees/{employee_id}/associated_persons
  method: get
  operationId: list-associated-persons
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/associated_persons
  method: post
  operationId: create-associated-person
  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: /employees/{employee_id}/associated_persons/{associated_person_id}
  method: get
  operationId: retrieve-associated-person
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/associated_persons/{associated_person_id}
  method: put
  operationId: update-associated-person
  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: /employees/{employee_id}/associated_persons/{associated_person_id}
  method: delete
  operationId: delete-associated-person
  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: /dependents_management_intents/{dependents_management_intent_id}
  method: get
  operationId: retrieve-dependents-management-intent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /dependents_management_intents/{dependents_management_intent_id}/associated_persons_eligibility
  method: get
  operationId: get-associated-persons-eligibility
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /dependents_management_intents/{dependents_management_intent_id}/dependents
  method: post
  operationId: add-dependents-to-dependents-management-intent
  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: /dependents_management_intents/{dependents_management_intent_id}/dependents/{associated_person_id}
  method: delete
  operationId: remove-dependent-from-dependents-management-intent
  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: /dependents_management_intents/{dependents_management_intent_id}/confirm
  method: post
  operationId: confirm-dependents-management-intent
  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: /dependents_management_intents/{dependents_management_intent_id}/cancel
  method: post
  operationId: cancel-dependents-management-intent
  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: /enrolment_intents
  method: get
  operationId: list-enrolment-intents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /enrolment_intents
  method: post
  operationId: create-enrolment-intent
  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: /enrolment_intents/{enrolment_intent_id}
  method: get
  operationId: retrieve-enrolment-intent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /enrolment_intents/{enrolment_intent_id}
  method: put
  operationId: update-enrolment-intent-configuration
  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: /enrolment_intents/{enrolment_intent_id}/requirements
  method: get
  operationId: list-enrolment-intent-requirements
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /enrolment_intents/{enrolment_intent_id}/confirm
  method: post
  operationId: confirm-enrolment-intent
  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: /enrolment_intents/{enrolment_intent_id}/reject
  method: post
  operationId: reject-enrolment-intent
  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: /enrolment_intents/{enrolment_intent_id}/coverage-selections
  method: post
  operationId: submit-enrolment-intent-coverage-selections
  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: /enrolment_intents/{enrolment_intent_id}/create_dependents_management_intent
  method: post
  operationId: create-dependents-management-intent-for-enrolment-intent
  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: /events/{event_id}/replay
  method: post
  operationId: replay-event
  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: /group_policies
  method: get
  operationId: list-group-policies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_policies/{group_policy_id}
  method: get
  operationId: retrieve-group-policy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_policy_intents
  method: get
  operationId: list-group-policy-intents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_policy_intents
  method: post
  operationId: create-group-policy-intent
  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: /group_policy_intents/{group_policy_intent_id}
  method: get
  operationId: retrieve-group-policy-intent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_policy_intents/{group_policy_intent_id}/requirements
  method: get
  operationId: list-group-policy-intent-requirements
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_quote_intents
  method: get
  operationId: list-group-quote-intents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_quote_intents
  method: post
  operationId: create-group-quote-intent
  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: /group_quote_intents/{group_quote_intent_id}
  method: get
  operationId: retrieve-group-quote-intent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_quote_intents/{group_quote_intent_id}/requirements
  method: get
  operationId: list-group-quote-intent-requirements
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_quote_intents/{group_quote_intent_id}/quote
  method: get
  operationId: get-group-quote-intent-quote
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /group_quote_intents/{group_quote_intent_id}/reject
  method: post
  operationId: reject-group-quote-intent
  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: /groups
  method: get
  operationId: list-groups
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /groups
  method: post
  operationId: create-group
  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: /groups/{group_id}
  method: get
  operationId: retrieve-group
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /groups/{group_id}
  method: put
  operationId: update-group
  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: /groups/{group_id}/employees
  method: get
  operationId: list-group-employees
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /groups/{group_id}/employees
  method: post
  operationId: add-employee-to-group
  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: /groups/{group_id}/eligibility_check
  method: post
  operationId: check-group-eligibility
  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: /hosted/sessions
  method: post
  operationId: create-hosted-session
  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: /plans
  method: get
  operationId: list-plans
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /plans/{plan_id}
  method: get
  operationId: retrieve-plan
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /policies
  method: get
  operationId: list-policies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /policies/{policy_id}
  method: get
  operationId: retrieve-policy
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /policies/{policy_id}/policy_amendment_intents
  method: get
  operationId: list-policy-amendment-intents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /policies/{policy_id}/policy_amendment_intents
  method: post
  operationId: create-policy-amendment-intent
  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: /policies/{policy_id}/policy_amendment_intents/{policy_amendment_intent_id}
  method: get
  operationId: retrieve-policy-amendment-intent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /policies/{policy_id}/policy_amendment_intents/{policy_amendment_intent_id}/confirm
  method: post
  operationId: confirm-policy-amendment-intent
  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: /policies/{policy_id}/policy_amendment_intents/{id}/cancel
  method: post
  operationId: cancel-policy-amendment-intent
  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: /policies/{policy_id}/policy_amendment_intents/{id}/create_dependents_management_intent
  method: post
  operationId: create-dependents-management-intent-for-policy-amendment
  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: /policy_import_intents
  method: get
  operationId: list-policy-import-intents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /policy_import_intents
  method: post
  operationId: create-policy-import-intent
  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: /policy_import_intents/{policy_import_intent_id}
  method: get
  operationId: retrieve-policy-import-intent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /providers
  method: get
  operationId: list-providers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /providers/{provider_id}
  method: get
  operationId: retrieve-provider
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/associated_persons
  method: post
  operationId: CreateAssociatedPerson
  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: /employees/{employee_id}/associated_persons
  method: get
  operationId: ListAssociatedPersons
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/associated_persons/{associated_person_id}
  method: get
  operationId: RetrieveAssociatedPerson
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}/associated_persons/{associated_person_id}
  method: put
  operationId: UpdateAssociatedPerson
  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: /employees/{employee_id}/associated_persons/{associated_person_id}
  method: delete
  operationId: DeleteAssociatedPerson
  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: /contribution_reports/{contribution_report_id}
  method: get
  operationId: RetrieveContributionReport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contribution_reports
  method: get
  operationId: ListContributionReports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contribution_reports/{contribution_report_id}/finalize
  method: post
  operationId: FinalizeContributionReport
  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: /contribution_reports/{contribution_report_id}/employee_breakdowns/{employee_id}
  method: get
  operationId: RetrieveEmployeeBreakdownForContributionReport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contribution_reports/{contribution_report_id}/employee_breakdowns
  method: get
  operationId: ListEmployeeBreakdownsForContributionReport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /dependents_management_intents/{dependents_management_intent_id}
  method: get
  operationId: RetrieveDependentsManagementIntent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /dependents_management_intents/{dependents_management_intent_id}/associated_persons_eligibility
  method: get
  operationId: GetAssociatedPersonsEligibility
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /dependents_management_intents/{dependents_management_intent_id}/dependents
  method: post
  operationId: AddDependentsToDependentsManagementIntent
  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: /dependents_management_intents/{dependents_management_intent_id}/dependents/{associated_person_id}
  method: delete
  operationId: RemoveDependentFromDependentsManagementIntent
  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: /dependents_management_intents/{dependents_management_intent_id}/confirm
  method: post
  operationId: ConfirmDependentsManagementIntent
  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: /dependents_management_intents/{dependents_management_intent_id}/cancel
  method: post
  operationId: CancelDependentsManagementIntent
  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: /embed/sessions
  method: post
  operationId: CreateEmbedSession
  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: /employees
  method: post
  operationId: CreateEmployee
  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: /employees
  method: get
  operationId: ListEmployees
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /employees/{employee_id}
  method: put

# --- truncated at 32 KB (50 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kota/refs/heads/main/agentic-access/kota-agentic-access.yml