APIs.io Engineering Platform Email Security Settings API

openapi: 3.0.0
info:
  version: "1.0.0"
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 Email Security Settings API
  description: <fullname>Amazon API Gateway</fullname> <p>Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.</p>
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: apigateway
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/apigateway-2015-07-09.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: https://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: http://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
- url: https://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: Email Security Settings
paths:
  /accounts/{account_id}/email-security/settings/allow_patterns:
    delete:
      operationId: email_security_delete_allow_patterns
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      requestBody:
        content:
          application/json:
            schema:
              items:
                properties:
                  id:
                    example: 2401
                    format: int32
                    title: identifier
                    type: integer
                required:
                - id
                type: object
              minItems: 1
              type: array
        required: true
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      items:
                        properties:
                          id:
                            example: 2401
                            format: int32
                            title: identifier
                            type: integer
                        required:
                        - id
                        type: object
                      minItems: 1
                      type: array
                  required:
                  - result
                  type: object
          description: ''
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete multiple email allow patterns
      tags:
      - Email Security Settings
    get:
      description: List, search, and sort an accounts's email allow patterns.
      operationId: email_security_list_allow_patterns
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - description: Page number of paginated results.
        in: query
        name: page
        schema:
          default: 1
          format: int32
          minimum: 1
          type: integer
      - description: Number of results to display.
        in: query
        name: per_page
        schema:
          default: 20
          format: int32
          minimum: 1
          type: integer
      - description: The field to sort by.
        in: query
        name: order
        schema:
          enum:
          - pattern
          - created_at
          type: string
      - description: The sorting direction.
        in: query
        name: direction
        schema:
          allOf:
          - $ref: '#/components/schemas/email-security_SortingDirection'
      - description: 'Allows searching in multiple properties of a record simultaneously.

          This parameter is intended for human users, not automation. Its exact

          behavior is intentionally left unspecified and is subject to change

          in the future.'
        in: query
        name: search
        schema:
          type: string
      - in: query
        name: is_sender
        schema:
          type: boolean
      - in: query
        name: is_recipient
        schema:
          type: boolean
      - in: query
        name: is_spoof
        schema:
          type: boolean
      - in: query
        name: verify_sender
        schema:
          type: boolean
      - in: query
        name: pattern_type
        schema:
          allOf:
          - $ref: '#/components/schemas/email-security_PatternType'
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      items:
                        $ref: '#/components/schemas/email-security_AllowPattern'
                      type: array
                    result_info:
                      $ref: '#/components/schemas/email-security_ResultInfo'
                  required:
                  - result
                  - result_info
                  type: object
          description: List of allow-patterns for the provided account
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List email allow patterns
      tags:
      - Email Security Settings
    post:
      operationId: email_security_create_allow_pattern
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/email-security_CreateAllowPattern'
              - items:
                  $ref: '#/components/schemas/email-security_CreateAllowPattern'
                type: array
        required: true
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '201':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      oneOf:
                      - $ref: '#/components/schemas/email-security_AllowPattern'
                      - items:
                          $ref: '#/components/schemas/email-security_AllowPattern'
                        type: array
                  required:
                  - result
                  type: object
          description: Returns the newly created patterns in the same shape as the request body
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create an email allow pattern
      tags:
      - Email Security Settings
  /accounts/{account_id}/email-security/settings/allow_patterns/{pattern_id}:
    delete:
      operationId: email_security_delete_allow_pattern
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - in: path
        name: pattern_id
        required: true
        schema:
          example: 2401
          format: int32
          title: identifier
          type: integer
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      properties:
                        id:
                          example: 2401
                          format: int32
                          title: identifier
                          type: integer
                      required:
                      - id
                      type: object
                  required:
                  - result
                  type: object
          description: ''
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete an email allow pattern
      tags:
      - Email Security Settings
    get:
      operationId: email_security_get_allow_pattern
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - in: path
        name: pattern_id
        required: true
        schema:
          example: 2401
          format: int32
          title: identifier
          type: integer
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      allOf:
                      - additionalProperties: false
                        example:
                          comments: Trust all messages send from test@example.com
                          is_recipient: false
                          is_regex: false
                          is_sender: true
                          is_spoof: false
                          pattern: test@example.com
                          pattern_type: EMAIL
                          verify_sender: true
                        properties:
                          comments:
                            nullable: true
                            type: string
                          is_recipient:
                            type: boolean
                          is_regex:
                            type: boolean
                          is_sender:
                            type: boolean
                          is_spoof:
                            type: boolean
                          pattern:
                            minLength: 1
                            type: string
                          pattern_type:
                            $ref: '#/components/schemas/email-security_PatternType'
                          verify_sender:
                            type: boolean
                        required:
                        - is_recipient
                        - is_sender
                        - is_spoof
                        - pattern
                        - is_regex
                        - verify_sender
                        - pattern_type
                        type: object
                      - properties:
                          created_at:
                            format: date-time
                            type: string
                          id:
                            example: 2401
                            format: int32
                            title: identifier
                            type: integer
                          last_modified:
                            format: date-time
                            type: string
                        required:
                        - id
                        - created_at
                        - last_modified
                        type: object
                      example:
                        comments: Trust all messages send from test@example.com
                        created_at: '2023-11-14T22:13:20Z'
                        id: 2401
                        is_recipient: false
                        is_regex: false
                        is_sender: true
                        is_spoof: false
                        last_modified: '2023-11-14T22:13:20Z'
                        pattern: test@example.com
                        pattern_type: EMAIL
                        verify_sender: true
                  required:
                  - result
                  type: object
          description: ''
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Get an email allow pattern
      tags:
      - Email Security Settings
    patch:
      operationId: email_security_update_allow_pattern
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - in: path
        name: pattern_id
        required: true
        schema:
          example: 2401
          format: int32
          title: identifier
          type: integer
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                comments:
                  nullable: true
                  type: string
                is_recipient:
                  nullable: true
                  type: boolean
                is_regex:
                  nullable: true
                  type: boolean
                is_sender:
                  nullable: true
                  type: boolean
                is_spoof:
                  nullable: true
                  type: boolean
                pattern:
                  minLength: 1
                  nullable: true
                  type: string
                pattern_type:
                  allOf:
                  - $ref: '#/components/schemas/email-security_PatternType'
                  - nullable: true
                    type: string
                verify_sender:
                  nullable: true
                  type: boolean
              type: object
        required: true
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      allOf:
                      - additionalProperties: false
                        example:
                          comments: Trust all messages send from test@example.com
                          is_recipient: false
                          is_regex: false
                          is_sender: true
                          is_spoof: false
                          pattern: test@example.com
                          pattern_type: EMAIL
                          verify_sender: true
                        properties:
                          comments:
                            nullable: true
                            type: string
                          is_recipient:
                            type: boolean
                          is_regex:
                            type: boolean
                          is_sender:
                            type: boolean
                          is_spoof:
                            type: boolean
                          pattern:
                            minLength: 1
                            type: string
                          pattern_type:
                            $ref: '#/components/schemas/email-security_PatternType'
                          verify_sender:
                            type: boolean
                        required:
                        - is_recipient
                        - is_sender
                        - is_spoof
                        - pattern
                        - is_regex
                        - verify_sender
                        - pattern_type
                        type: object
                      - properties:
                          created_at:
                            format: date-time
                            type: string
                          id:
                            example: 2401
                            format: int32
                            title: identifier
                            type: integer
                          last_modified:
                            format: date-time
                            type: string
                        required:
                        - id
                        - created_at
                        - last_modified
                        type: object
                      example:
                        comments: Trust all messages send from test@example.com
                        created_at: '2023-11-14T22:13:20Z'
                        id: 2401
                        is_recipient: false
                        is_regex: false
                        is_sender: true
                        is_spoof: false
                        last_modified: '2023-11-14T22:13:20Z'
                        pattern: test@example.com
                        pattern_type: EMAIL
                        verify_sender: true
                  required:
                  - result
                  type: object
          description: ''
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Update an email allow pattern
      tags:
      - Email Security Settings
  /accounts/{account_id}/email-security/settings/block_senders:
    delete:
      operationId: email_security_delete_blocked_senders
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      requestBody:
        content:
          application/json:
            schema:
              items:
                properties:
                  id:
                    example: 2402
                    format: int32
                    title: identifier
                    type: integer
                required:
                - id
                type: object
              minItems: 1
              type: array
        required: true
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      items:
                        properties:
                          id:
                            example: 2402
                            format: int32
                            title: identifier
                            type: integer
                        required:
                        - id
                        type: object
                      minItems: 1
                      type: array
                  required:
                  - result
                  type: object
          description: ''
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete multiple blocked email senders
      tags:
      - Email Security Settings
    get:
      operationId: email_security_list_blocked_senders
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - description: Page number of paginated results.
        in: query
        name: page
        schema:
          default: 1
          format: int32
          minimum: 1
          type: integer
      - description: Number of results to display.
        in: query
        name: per_page
        schema:
          default: 20
          format: int32
          minimum: 1
          type: integer
      - description: The field to sort by.
        in: query
        name: order
        schema:
          enum:
          - pattern
          - created_at
          type: string
      - description: The sorting direction.
        in: query
        name: direction
        schema:
          allOf:
          - $ref: '#/components/schemas/email-security_SortingDirection'
      - description: 'Allows searching in multiple properties of a record simultaneously.

          This parameter is intended for human users, not automation. Its exact

          behavior is intentionally left unspecified and is subject to change

          in the future.'
        in: query
        name: search
        schema:
          type: string
      - in: query
        name: pattern_type
        schema:
          allOf:
          - $ref: '#/components/schemas/email-security_PatternType'
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      items:
                        $ref: '#/components/schemas/email-security_BlockedSender'
                      type: array
                    result_info:
                      $ref: '#/components/schemas/email-security_ResultInfo'
                  required:
                  - result
                  - result_info
                  type: object
          description: List of blocked senders for the provided account
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List blocked email senders
      tags:
      - Email Security Settings
    post:
      operationId: email_security_create_blocked_sender
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/email-security_CreateBlockedSender'
              - items:
                  $ref: '#/components/schemas/email-security_CreateBlockedSender'
                type: array
        required: true
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '201':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      oneOf:
                      - $ref: '#/components/schemas/email-security_BlockedSender'
                      - items:
                          $ref: '#/components/schemas/email-security_BlockedSender'
                        type: array
                  required:
                  - result
                  type: object
          description: Returns the newly created patterns in the same shape as the request body
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create a blocked email sender
      tags:
      - Email Security Settings
  /accounts/{account_id}/email-security/settings/block_senders/{pattern_id}:
    delete:
      operationId: email_security_delete_blocked_sender
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - in: path
        name: pattern_id
        required: true
        schema:
          example: 2402
          format: int32
          title: identifier
          type: integer
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      properties:
                        id:
                          example: 2402
                          format: int32
                          title: identifier
                          type: integer
                      required:
                      - id
                      type: object
                  required:
                  - result
                  type: object
          description: ''
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete a blocked email sender
      tags:
      - Email Security Settings
    get:
      operationId: email_security_get_blocked_sender
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - in: path
        name: pattern_id
        required: true
        schema:
          example: 2402
          format: int32
          title: identifier
          type: integer
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      allOf:
                      - additionalProperties: false
                        example:
                          comments: block sender with email test@example.com
                          is_regex: false
                          pattern: test@example.com
                          pattern_type: EMAIL
                        properties:
                          comments:
                            nullable: true
                            type: string
                          is_regex:
                            type: boolean
                          pattern:
                            minLength: 1
                            type: string
                          pattern_type:
                            $ref: '#/components/schemas/email-security_PatternType'
                        required:
                        - pattern
                        - is_regex
                        - pattern_type
                        type: object
                      - properties:
                          created_at:
                            format: date-time
                            type: string
                          id:
                            example: 2402
                            format: int32
                            title: identifier
                            type: integer
                          last_modified:
                            format: date-time
                            type: string
                        required:
                        - id
                        - created_at
                        - last_modified
                        type: object
                      example:
                        comments: block sender with email test@example.com
                        created_at: '2023-11-14T22:13:20Z'
                        id: 2402
                        is_regex: false
                        last_modified: '2023-11-14T22:13:20Z'
                        pattern: test@example.com
                        pattern_type: EMAIL
                  required:
                  - result
                  type: object
          description: ''
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Get a blocked email sender
      tags:
      - Email Security Settings
    patch:
      operationId: email_security_update_blocked_sender
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/email-security_AccountId'
      - in: path
        name: pattern_id
        required: true
        schema:
          example: 2402
          format: int32
          title: identifier
          type: integer
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                comments:
                  nullable: true
                  type: string
                is_regex:
                  nullable: true
                  type: boolean
                pattern:
                  minLength: 1
                  nullable: true
                  type: string
                pattern_type:
                  allOf:
                  - $ref: '#/components/schemas/email-security_PatternType'
                  - nullable: true
                    type: string
              type: object
        required: true
      responses:
        4XX:
          $ref: '#/components/responses/email-security_ClientError'
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/email-security_ApiResponseCommon'
                - properties:
                    result:
                      allOf:
                      - additionalProperties: false
                        example:
                          comments: block sender with email test@example.com
                          is_regex: false
                          pattern: test@example.com
                          pattern_type: EMAIL
                        properties:
                          comments:
                            nullable: true
                            type: string
                          is_regex:
                            type: boolean
                          pattern:
                            minLength: 1
                            type: string
                          pattern_type:
                            $ref: '#/components/schemas/email-security_PatternType'
                        required:
                        - pattern
                        - is_regex
                        - pattern_type
                        type: object
                      - properties:
                          c

# --- truncated at 32 KB (81 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/apis-io-engineering-platform/refs/heads/main/openapi/engineering-platform-email-security-settings-api-openapi.yml