APIs.io Engineering Platform Cloudflare API — Email Security

naftiko: 1.0.0-alpha2
info:
  label: APIs.io Engineering Platform Cloudflare API — Email Security
  description: 'APIs.io Engineering Platform Cloudflare API — Email Security. 7 operations. Lead operation: APIs.io Engineering
    Platform Search email messages. Self-contained Naftiko capability covering one Engineering Platform business surface.'
  tags:
  - Engineering Platform
  - Email Security
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ENGINEERING_PLATFORM_API_KEY: ENGINEERING_PLATFORM_API_KEY
capability:
  consumes:
  - type: http
    namespace: cloudflare-email-security
    baseUri: ''
    description: APIs.io Engineering Platform Cloudflare API — Email Security business capability. Self-contained, no shared
      references.
    resources:
    - name: accounts-account_id-email-security-investigate
      path: /accounts/{account_id}/email-security/investigate
      operations:
      - name: emailsecurityinvestigate
        method: GET
        description: APIs.io Engineering Platform Search email messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: start
          in: query
          type: string
          description: The beginning of the search date range.
        - name: end
          in: query
          type: string
          description: The end of the search date range.
        - name: query
          in: query
          type: string
          description: Space delimited query term(s).
        - name: detections_only
          in: query
          type: boolean
          description: If `false`, the search includes non-detections.
        - name: action_log
          in: query
          type: boolean
          description: Controls whether the message action log in included in the response.
        - name: final_disposition
          in: query
          type: string
          description: Filter messages by the provided disposition.
        - name: metric
          in: query
          type: string
        - name: message_action
          in: query
          type: string
          description: Filter messages by actions applied to them
        - name: recipient
          in: query
          type: string
        - name: sender
          in: query
          type: string
        - name: alert_id
          in: query
          type: string
        - name: domain
          in: query
          type: string
          description: Filter by the sender domain
        - name: message_id
          in: query
          type: string
        - name: page
          in: query
          type: integer
          description: Page number of paginated results.
        - name: per_page
          in: query
          type: integer
          description: Number of results to display.
    - name: accounts-account_id-email-security-investigate-postfix_id
      path: /accounts/{account_id}/email-security/investigate/{postfix_id}
      operations:
      - name: emailsecuritygetmessage
        method: GET
        description: APIs.io Engineering Platform Get message details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: postfix_id
          in: path
          type: string
          required: true
    - name: accounts-account_id-email-security-investigate-postfix_id-detections
      path: /accounts/{account_id}/email-security/investigate/{postfix_id}/detections
      operations:
      - name: emailsecuritygetmessagedetections
        method: GET
        description: APIs.io Engineering Platform Get message detection details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: postfix_id
          in: path
          type: string
          required: true
    - name: accounts-account_id-email-security-investigate-postfix_id-preview
      path: /accounts/{account_id}/email-security/investigate/{postfix_id}/preview
      operations:
      - name: emailsecuritygetmessagepreview
        method: GET
        description: APIs.io Engineering Platform Get email preview
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: postfix_id
          in: path
          type: string
          required: true
    - name: accounts-account_id-email-security-investigate-postfix_id-raw
      path: /accounts/{account_id}/email-security/investigate/{postfix_id}/raw
      operations:
      - name: emailsecuritygetmessageraw
        method: GET
        description: APIs.io Engineering Platform Get raw email content
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: postfix_id
          in: path
          type: string
          required: true
    - name: accounts-account_id-email-security-investigate-postfix_id-trace
      path: /accounts/{account_id}/email-security/investigate/{postfix_id}/trace
      operations:
      - name: emailsecuritygetmessagetrace
        method: GET
        description: APIs.io Engineering Platform Get email trace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: postfix_id
          in: path
          type: string
          required: true
    - name: accounts-account_id-email-security-phishguard-reports
      path: /accounts/{account_id}/email-security/phishguard/reports
      operations:
      - name: emailsecuritygetphishguardreports
        method: GET
        description: APIs.io Engineering Platform Get PhishGuard reports
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
        - name: from_date
          in: query
          type: string
          required: true
        - name: to_date
          in: query
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.ENGINEERING_PLATFORM_API_KEY}}'
  exposes:
  - type: rest
    namespace: cloudflare-email-security-rest
    port: 8080
    description: REST adapter for APIs.io Engineering Platform Cloudflare API — Email Security. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/accounts/{account-id}/email-security/investigate
      name: accounts-account-id-email-security-investigate
      description: REST surface for accounts-account_id-email-security-investigate.
      operations:
      - method: GET
        name: emailsecurityinvestigate
        description: APIs.io Engineering Platform Search email messages
        call: cloudflare-email-security.emailsecurityinvestigate
        with:
          account_id: rest.account_id
          start: rest.start
          end: rest.end
          query: rest.query
          detections_only: rest.detections_only
          action_log: rest.action_log
          final_disposition: rest.final_disposition
          metric: rest.metric
          message_action: rest.message_action
          recipient: rest.recipient
          sender: rest.sender
          alert_id: rest.alert_id
          domain: rest.domain
          message_id: rest.message_id
          page: rest.page
          per_page: rest.per_page
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/email-security/investigate/{postfix-id}
      name: accounts-account-id-email-security-investigate-postfix-id
      description: REST surface for accounts-account_id-email-security-investigate-postfix_id.
      operations:
      - method: GET
        name: emailsecuritygetmessage
        description: APIs.io Engineering Platform Get message details
        call: cloudflare-email-security.emailsecuritygetmessage
        with:
          account_id: rest.account_id
          postfix_id: rest.postfix_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/email-security/investigate/{postfix-id}/detections
      name: accounts-account-id-email-security-investigate-postfix-id-detections
      description: REST surface for accounts-account_id-email-security-investigate-postfix_id-detections.
      operations:
      - method: GET
        name: emailsecuritygetmessagedetections
        description: APIs.io Engineering Platform Get message detection details
        call: cloudflare-email-security.emailsecuritygetmessagedetections
        with:
          account_id: rest.account_id
          postfix_id: rest.postfix_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/email-security/investigate/{postfix-id}/preview
      name: accounts-account-id-email-security-investigate-postfix-id-preview
      description: REST surface for accounts-account_id-email-security-investigate-postfix_id-preview.
      operations:
      - method: GET
        name: emailsecuritygetmessagepreview
        description: APIs.io Engineering Platform Get email preview
        call: cloudflare-email-security.emailsecuritygetmessagepreview
        with:
          account_id: rest.account_id
          postfix_id: rest.postfix_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/email-security/investigate/{postfix-id}/raw
      name: accounts-account-id-email-security-investigate-postfix-id-raw
      description: REST surface for accounts-account_id-email-security-investigate-postfix_id-raw.
      operations:
      - method: GET
        name: emailsecuritygetmessageraw
        description: APIs.io Engineering Platform Get raw email content
        call: cloudflare-email-security.emailsecuritygetmessageraw
        with:
          account_id: rest.account_id
          postfix_id: rest.postfix_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/email-security/investigate/{postfix-id}/trace
      name: accounts-account-id-email-security-investigate-postfix-id-trace
      description: REST surface for accounts-account_id-email-security-investigate-postfix_id-trace.
      operations:
      - method: GET
        name: emailsecuritygetmessagetrace
        description: APIs.io Engineering Platform Get email trace
        call: cloudflare-email-security.emailsecuritygetmessagetrace
        with:
          account_id: rest.account_id
          postfix_id: rest.postfix_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounts/{account-id}/email-security/phishguard/reports
      name: accounts-account-id-email-security-phishguard-reports
      description: REST surface for accounts-account_id-email-security-phishguard-reports.
      operations:
      - method: GET
        name: emailsecuritygetphishguardreports
        description: APIs.io Engineering Platform Get PhishGuard reports
        call: cloudflare-email-security.emailsecuritygetphishguardreports
        with:
          account_id: rest.account_id
          from_date: rest.from_date
          to_date: rest.to_date
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloudflare-email-security-mcp
    port: 9090
    transport: http
    description: MCP adapter for APIs.io Engineering Platform Cloudflare API — Email Security. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: apis-io-engineering-platform-search-email
      description: APIs.io Engineering Platform Search email messages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudflare-email-security.emailsecurityinvestigate
      with:
        account_id: tools.account_id
        start: tools.start
        end: tools.end
        query: tools.query
        detections_only: tools.detections_only
        action_log: tools.action_log
        final_disposition: tools.final_disposition
        metric: tools.metric
        message_action: tools.message_action
        recipient: tools.recipient
        sender: tools.sender
        alert_id: tools.alert_id
        domain: tools.domain
        message_id: tools.message_id
        page: tools.page
        per_page: tools.per_page
      outputParameters:
      - type: object
        mapping: $.
    - name: apis-io-engineering-platform-get-message
      description: APIs.io Engineering Platform Get message details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudflare-email-security.emailsecuritygetmessage
      with:
        account_id: tools.account_id
        postfix_id: tools.postfix_id
      outputParameters:
      - type: object
        mapping: $.
    - name: apis-io-engineering-platform-get-message-2
      description: APIs.io Engineering Platform Get message detection details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudflare-email-security.emailsecuritygetmessagedetections
      with:
        account_id: tools.account_id
        postfix_id: tools.postfix_id
      outputParameters:
      - type: object
        mapping: $.
    - name: apis-io-engineering-platform-get-email
      description: APIs.io Engineering Platform Get email preview
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudflare-email-security.emailsecuritygetmessagepreview
      with:
        account_id: tools.account_id
        postfix_id: tools.postfix_id
      outputParameters:
      - type: object
        mapping: $.
    - name: apis-io-engineering-platform-get-raw
      description: APIs.io Engineering Platform Get raw email content
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudflare-email-security.emailsecuritygetmessageraw
      with:
        account_id: tools.account_id
        postfix_id: tools.postfix_id
      outputParameters:
      - type: object
        mapping: $.
    - name: apis-io-engineering-platform-get-email-2
      description: APIs.io Engineering Platform Get email trace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudflare-email-security.emailsecuritygetmessagetrace
      with:
        account_id: tools.account_id
        postfix_id: tools.postfix_id
      outputParameters:
      - type: object
        mapping: $.
    - name: apis-io-engineering-platform-get-phishguard
      description: APIs.io Engineering Platform Get PhishGuard reports
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudflare-email-security.emailsecuritygetphishguardreports
      with:
        account_id: tools.account_id
        from_date: tools.from_date
        to_date: tools.to_date
      outputParameters:
      - type: object
        mapping: $.