generated: '2026-07-15'
method: generated
source: openapi/mailtrap-email-api-openapi.yml, openapi/mailtrap-email-sandbox-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: 23
  by_action_class:
    acting: 12
    connected: 11
  by_consequence:
    physical: 3
    read: 11
    write: 8
    safety-critical: 1
  human_in_the_loop_required: 1
operations:
- path: /api/send
  method: post
  operationId: sendEmail
  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/batch
  method: post
  operationId: sendBatchEmails
  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/send/{inbox_id}
  method: post
  operationId: sendToSandboxInbox
  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/accounts/{account_id}/inboxes
  method: get
  operationId: listInboxes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/projects/{project_id}/inboxes
  method: post
  operationId: createInbox
  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/accounts/{account_id}/inboxes/{inbox_id}
  method: get
  operationId: getInbox
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}
  method: delete
  operationId: deleteInbox
  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/accounts/{account_id}/inboxes/{inbox_id}
  method: patch
  operationId: updateInbox
  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/accounts/{account_id}/inboxes/{inbox_id}/clean
  method: patch
  operationId: cleanInbox
  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/accounts/{account_id}/inboxes/{inbox_id}/all_read
  method: patch
  operationId: markAllRead
  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/accounts/{account_id}/inboxes/{inbox_id}/reset_credentials
  method: patch
  operationId: resetCredentials
  x-agentic-access:
    action-class: acting
    consequence: safety-critical
    subject: required
    audience: null
    token:
      max-ttl: 120
      exchange: true
      purpose-required: true
      proof-of-possession: true
    escalation:
      human-in-the-loop: required
    audit: required
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages
  method: get
  operationId: listMessages
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}
  method: get
  operationId: getMessage
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}
  method: patch
  operationId: updateMessage
  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/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}
  method: delete
  operationId: deleteMessage
  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/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/forward
  method: post
  operationId: forwardMessage
  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/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/spam_report
  method: get
  operationId: getSpamReport
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/analyze
  method: get
  operationId: getHtmlAnalyze
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/body.txt
  method: get
  operationId: getMessageBodyText
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/body.html
  method: get
  operationId: getMessageBodyHtml
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/body.raw
  method: get
  operationId: getMessageBodyRaw
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/body.eml
  method: get
  operationId: getMessageEml
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/mail_headers
  method: get
  operationId: getMessageHeaders
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none