generated: '2026-07-15'
method: generated
source: openapi/parea-rest-api-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: 20
  by_action_class:
    connected: 4
    acting: 16
  by_consequence:
    read: 4
    write: 15
    physical: 1
  human_in_the_loop_required: 0
operations:
- path: /api/parea/v1/
  method: get
  operationId: health_check_api_parea_v1__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/parea/v1/completion
  method: post
  operationId: completion_api_parea_v1_completion_post
  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/parea/v1/completion/stream
  method: post
  operationId: stream_completion_api_parea_v1_completion_stream_post
  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/parea/v1/deployed-prompt
  method: post
  operationId: fetch_deployed_prompt_api_parea_v1_deployed_prompt_post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/parea/v1/feedback
  method: post
  operationId: record_feedback_api_parea_v1_feedback_post
  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/parea/v1/trace_log
  method: put
  operationId: update_trace_log_api_parea_v1_trace_log_put
  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/parea/v1/trace_log
  method: post
  operationId: record_trace_log_api_parea_v1_trace_log_post
  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/parea/v1/trace_log/langchain
  method: post
  operationId: record_langchain_trace_log_api_parea_v1_trace_log_langchain_post
  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/parea/v1/experiment
  method: post
  operationId: create_experiment_api_api_parea_v1_experiment_post
  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/parea/v1/experiment/{experiment_uuid}/stats
  method: get
  operationId: get_experiment_stats_api_api_parea_v1_experiment__experiment_uuid__stats_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/parea/v1/experiment/{experiment_uuid}/finished
  method: post
  operationId: finish_experiment_api_api_parea_v1_experiment__experiment_uuid__finished_post
  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/parea/v1/project
  method: post
  operationId: create_or_get_project_api_api_parea_v1_project_post
  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/parea/v1/collection/{test_collection_identifier}
  method: get
  operationId: get_test_case_collection_by_identifier_api_parea_v1_collection__test_collection_identifier__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/parea/v1/collection
  method: post
  operationId: create_collection_api_parea_v1_collection_post
  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/parea/v1/testcases
  method: post
  operationId: create_test_cases_for_dataset_api_parea_v1_testcases_post
  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/parea/v1/trace_log/{trace_id}
  method: get
  operationId: get_trace_log_api_api_parea_v1_trace_log__trace_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/parea/v1/experiments
  method: post
  operationId: list_experiments_api_api_parea_v1_experiments_post
  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/parea/v1/experiment/{experiment_uuid}/trace_logs
  method: post
  operationId: get_experiment_trace_logs_api_api_parea_v1_experiment__experiment_uuid__trace_logs_post
  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/parea/v1/get_trace_logs
  method: post
  operationId: get_trace_logs_api_api_parea_v1_get_trace_logs_post
  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/parea/v1/update_test_case/{dataset_id}/{test_case_id}
  method: post
  operationId: update_test_case_api_parea_v1_update_test_case__dataset_id___test_case_id__post
  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