Meddra Agentic Access

generated: '2026-09-17'
method: generated
source: openapi/meddra-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: 16
  by_action_class:
    connected: 16
  by_consequence:
    read: 16
  human_in_the_loop_required: 0
operations:
- path: /api/di
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/detail
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/downld/{lang}/{ver}/{file}/{format}
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - meddraapi
- path: /api/export
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/gt
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/hier
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/hist/{code}/{htype}/{lang}/{rsview}
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - meddraapi
- path: /api/hist/{term}/{lang}/{rsview}
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - meddraapi
- path: /api/lang/{langt}
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - meddraapi
- path: /api/rel
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - meddraapi
- path: /api/search
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/smqa
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/status
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
    scope:
    - meddraapi
- path: /api/sv
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/type
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
- path: /api/vr
  method: post
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
    scope:
    - meddraapi
    x-review-note: 'Reclassified by hand: the heuristic reads POST as a mutation. This operation POSTs a query body
      and returns dictionary data; the MedDRA API has no write surface.'
review:
  reviewed: '2026-09-17'
  by: API Evangelist enrichment pass
  note: 'The generator classifies every POST as an acting/write operation. That is wrong for MedDRA: ten of its sixteen
    operations are POSTs that carry a JSON query body (search terms, code lists, version pairs) and return dictionary
    data. Nothing in this API creates, updates or deletes anything on the MSSO side, so all sixteen are reclassified
    connected/read. The one operation that deserves extra care is GET /api/downld/... , which retrieves MedDRA distribution
    files - the constraint there is the MedDRA licence, not a write consequence.'
  operations_reclassified: 10