generated: '2026-07-17'
method: generated
source: openapi/truora-openapi.yml
description: Recommended x-agentic-access execution contracts, classified heuristically from
  the modeled OpenAPI. A governance starting point for exposing this API to AI agents - review
  and bind audience per deployment. Because Truora operates on regulated personal identity data,
  write operations that create checks, validations, or identity processes carry a required
  human-in-the-loop, since they act on real people's PII and require explicit user authorization.
  See research/curity/agentic-governance/.
summary:
  operations: 12
  by_action_class:
    acting: 6
    connected: 6
  by_consequence:
    write: 6
    read: 6
  human_in_the_loop_required: 4
operations:
- path: /v1/checks
  method: post
  operationId: createCheck
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: required
      triggers:
      - pii
      - high-value
    audit: required
- path: /v1/checks
  method: get
  operationId: listChecks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/checks/{check_id}
  method: get
  operationId: getCheck
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/checks/{check_id}
  method: delete
  operationId: deleteCheck
  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: /v1/checks/{check_id}/attachments
  method: get
  operationId: getCheckAttachments
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/continuous-check
  method: post
  operationId: createContinuousCheck
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: required
      triggers:
      - pii
      - high-value
    audit: required
- path: /v1/validations
  method: post
  operationId: createValidation
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: required
      triggers:
      - pii
      - high-value
    audit: required
- path: /v1/validations/{validation_id}
  method: get
  operationId: getValidation
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/processes/{process_id}
  method: get
  operationId: getProcess
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/processes/{process_id}/result
  method: get
  operationId: getProcessResult
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/api-keys
  method: post
  operationId: createApiKey
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: required
      triggers:
      - credential-issuance
      - high-value
    audit: required
- path: /v1/api-keys/{api_key_id}
  method: delete
  operationId: deleteApiKey
  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