openapi: 3.1.0
info:
  title: Alerts
  description: >-
    Our alerting solution is centered around two concepts: events and channels.
    The occurrence of an event can be configured to trigger an alert. A channel
    describes the delivery method for an alert. Every configured alert consists
    of an event type / channel pair. This level of granularity allows alerting
    to be configured to your exact preference.
  version: 0.0.1
servers:
  - url: https://api.mailgun.net
    description: US Mailgun
  - url: https://api.eu.mailgun.net
    description: EU Mailgun
tags:
  - name: Alerts
    x-displayName: Alerts
  - name: Domains
    x-displayName: Domains
  - name: IP Blocklist Monitoring
    x-displayName: IP Blocklist Monitoring
  - name: Email Preview
    description: >-
      This API provides functionality to create and manage email preview tests,
      as well as create shareable links.
    x-displayName: Email Preview
  - name: Domain Blocklist Monitoring
    description: >-
      Blocklist Monitoring enables you to keep an eye on your reputation.
      Monitor your domains against our curated list of blocklist providers to
      make sure you aren't being blocked.
    x-displayName: Domain Blocklist Monitoring
  - name: Spam Traps Monitoring
    description: >-
      Our spam trap monitoring service surfaces how much of your email is being
      sent to known spam traps.
    x-displayName: Spam Traps Monitoring
  - name: openapi-spamtraps_other
    x-displayName: other
  - name: Inbox Placement
    description: >-
      Inbox Placement testing allows you to see the likely deliverability of
      your email campaigns.
    x-displayName: Inbox Placement
  - name: Email Health Score
    x-displayName: Email Health Score
  - name: Google Postmaster Tools
    description: This API provides access to Google Postmaster data.
    x-displayName: Google Postmaster Tools
  - name: Microsoft SNDS
    description: This API provides access to Microsoft SNDS data.
    x-displayName: Microsoft SNDS
  - name: openapi-reputationanalytics_other
    x-displayName: other
paths:
  /v1/alerts/events:
    get:
      tags:
        - Alerts
      summary: List events
      description: The current list of events that you can chose to receive alerts for.
      operationId: GET-v1-alerts-events
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-alerts-internal-api-ListAlertsEventsResp
              examples:
                Example:
                  value:
                    events:
                      - ip_listed
                      - ip_delisted
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/settings/events:
    post:
      tags:
        - Alerts
      summary: Add Alert
      description: >-
        Use this endpoint to add new alert settings record.


        ### Webhooks


        This section covers details around consuming Mailgun Optimize alerts via
        webhooks. If you are familiar with Mailgun Send webhooks, 

        there is a lot of overlapping similarity, however, there are also a few
        minor nuances to account for.


        #### Securing Webhooks


        HMAC is used to verified to integrity as well as the authenticity of
        received webhooks. To verify the origin of a webhook:


        1. Encode the webhook’s entire POST request body with the HMAC algorithm
        (using your webhook signing key and SHA256 digest mode)

        2. Compare the resulting hexdigest to the signature provided in the POST
        request’s X-Sign header.


        NOTE: If you’re consuming Mailgun Send webhooks, please note that your
        Mailgun Send webhook signing key differs 

        from your Mailgun Optimize alerts webhook signing key. 

        Your Mailgun Optimize alerts webhook signing key is available within the
        Mailgun Optimize UI.


        #### Webhook URL Validation


        When adding or updating a webhook URL for alerts, we will ensure the
        endpoint is reachable by sending a GET request to the provided URL. If a
        200 response is not returned from your endpoint, the request will be
        rejected and your alert setting will not be saved. We intentionally
        chose to send a GET request instead of a POST when validating URLs so
        that your webhook endpoint does not have to account for test requests.


        Additionally, when a POST request is sent to your webhook URL, if a 2xx
        is not returned, we will attempt retries via an exponential backoff
        strategy for up to ~8 hours. If the max retry count is reached, the
        alert will be disabled and the related alert settings record’s
        disabled_at field will be populated.
      operationId: POST-v1-alerts-settings-events
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-api-mutateEventSettingReq
            examples:
              Example:
                value:
                  event_type: ip_listed
                  channel: webhook
                  settings:
                    url: https://yourwebhookurl.com
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-alerts-internal-settings-EventSettings
              examples:
                Example:
                  value:
                    id: 00000000-0000-0000-0000-000000000000
                    event_type: ip_listed
                    channel: webhook
                    settings:
                      url: https://yourwebhookurl.com
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        '409':
          description: A 409 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/settings/events/{id}:
    put:
      tags:
        - Alerts
      summary: Update Alert
      description: >-
        Use this endpoint to update an existing alert setting record.


        NOTE: When updating a webhook alert, we will ensure the endpoint is
        reachable by sending a GET request to the provided URL. If a 200
        response is not returned, a 400 will be returned and the alert setting
        update will be rejected.
      operationId: PUT-v1-alerts-settings-events--id-
      parameters:
        - name: id
          in: path
          description: The settings ID.
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-api-mutateEventSettingReq
            examples:
              Example:
                value:
                  event_type: ip_delisted
                  channel: email
                  settings:
                    emails:
                      - recipient-a@example.com
                      - recipient-b@example.com
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: settings updated
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
    delete:
      tags:
        - Alerts
      summary: Remove Alert
      operationId: DELETE-v1-alerts-settings-events--id-
      parameters:
        - name: id
          in: path
          description: The settings ID.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: settings deleted
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/settings:
    get:
      tags:
        - Alerts
      summary: List Alerts
      description: >-
        This endpoint returns a list of all configured alert settings for your
        account.
      operationId: GET-v1-alerts-settings
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-alerts-internal-api-SettingsResponse
              examples:
                Example:
                  value:
                    events:
                      - id: 00000000-0000-0000-0000-000000000000
                        event_type: ip_listed
                        channel: webhook
                        settings:
                          url: https://example.com/delisted_hook
                      - id: 00000000-0000-0000-0000-000000000000
                        event_type: ip_delisted
                        channel: webhook
                        settings:
                          url: https://yourwebhookurl.com
                        disabled_at: '2006-01-02T22:04:05Z'
                      - id: 00000000-0000-0000-0000-000000000000
                        event_type: ip_delisted
                        channel: email
                        settings:
                          emails:
                            - recipient-1@example.com
                            - recipient-2@example.com
                    webhooks: {}
                    slack: {}
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/settings/slack:
    put:
      tags:
        - Alerts
      summary: Update Slack settings
      operationId: PUT-v1-alerts-settings-slack
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-settings-Slack
        required: true
      responses:
        '204':
          description: A 204 response
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
    delete:
      tags:
        - Alerts
      summary: Delete Slack settings
      description: >-
        Delete Slack settings and Slack event settings for the Mailgun account.


        To revoke the Slack access token, use DELETE /v1/alerts/slack/oauth.


        To completely remove the Slack App from Slack Workspace, go into App
        Configuration in Slack.
      operationId: DELETE-v1-alerts-settings-slack
      responses:
        '204':
          description: A 204 response
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/settings/webhooks/signing_key:
    put:
      tags:
        - Alerts
      summary: Reset Webhook Signing Key
      operationId: PUT-v1-alerts-settings-webhooks-signing-key
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-alerts-internal-api-ResetWebhooksSigningKeyResp
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/webhooks/test:
    post:
      tags:
        - Alerts
      summary: Test webhook
      description: Sends test webhook request to specified url with dummy data.
      operationId: POST-v1-alerts-webhooks-test
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-api-TestWebhookRequest
            examples:
              Example:
                value:
                  event_type: some-event
                  url: https://some-webhook-url.com/webhook
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/email/test:
    post:
      tags:
        - Alerts
      summary: Test message
      description: Sends test message to emails with dummy data.
      operationId: POST-v1-alerts-email-test
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-api-TestEmailRequest
            examples:
              Example:
                value:
                  event_type: some-event
                  emails:
                    - email1@example.com
                    - email2@example.com
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/slack/test:
    post:
      tags:
        - Alerts
      summary: Test message
      description: Sends test message to slack channels with dummy data.
      operationId: POST-v1-alerts-slack-test
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-api-TestSlackRequest
            examples:
              Example:
                value:
                  event_type: some-event
                  channel_ids:
                    - C0123
                    - C0456
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/slack/oauth:
    delete:
      tags:
        - Alerts
      summary: Revoke Slack access token
      description: >-
        Revoke Slack access token, delete Slack settings and Slack event
        settings.


        NOTE: All Mailgun accounts connected to the same Slack workspace share
        the same token.


        To completely remove the Slack App from Slack Workspace, go into App
        Configuration in Slack.
      operationId: DELETE-v1-alerts-slack-oauth
      responses:
        '204':
          description: A 204 response
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/alerts/slack/channels/{id}:
    get:
      tags:
        - Alerts
      summary: Get Slack channel
      description: Returns Slack channel.
      operationId: GET-v1-alerts-slack-channels--id-
      parameters:
        - name: id
          in: path
          description: The Slack channel ID.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-alerts-internal-api-SlackChannel
              examples:
                Example:
                  value:
                    id: C012AB3CD
                    name: general
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: token should have 'xoxb-' prefix
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: 'missing_scope: please reconnect the Slack App'
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: no settings
      security:
        - basicAuth: []
  /v1/alerts/slack/channels:
    get:
      tags:
        - Alerts
      summary: List Slack channels
      description: List Slack channels for the connected Slack workspace.
      operationId: GET-v1-alerts-slack-channels
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-alerts-internal-api-ListSlackChannelsResp
              examples:
                Example:
                  value:
                    items:
                      - id: C012AB3CD
                        name: general
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: token should have 'xoxb-' prefix
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: 'missing_scope: please reconnect the Slack App'
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: no settings
      security:
        - basicAuth: []
  /v1/inboxready/domains:
    get:
      tags:
        - Domains
      summary: Returns Domains on Mailgun Optimize services
      description: >-
        Will return details on an Mailgun Optimize Domain. If no Domain is
        provided, then a list of all Mailgun Optimize Domains on an account will
        be returned.
      operationId: GET-v1-inboxready-domains
      parameters:
        - name: limit
          in: query
          description: Limit
          schema:
            type: integer
        - name: domain
          in: query
          description: Domain name
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-DomainListResponse
              examples:
                Example:
                  value:
                    items:
                      - name: domain.tld
                        verified:
                          verified_at: 123456789
                          status: pending
                        services:
                          service_name: false
                        txt_record: IR-hashed-txt-record-key
                    paging:
                      previous: https://....
                      first: https://....
                      next: https://....
                      last: https://....
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
    post:
      tags:
        - Domains
      summary: Add a single domain to an account
      operationId: POST-v1-inboxready-domains
      parameters:
        - name: domain
          in: query
          description: Domain name
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-AddDomainResponse
              examples:
                Example:
                  value:
                    message: The domain has been added
                    domain:
                      name: domain.tld
                      verified:
                        verified_at: 123456789
                        status: pending
                      services:
                        service_name: false
                      txt_record: IR-hashed-txt-record-key
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
    delete:
      tags:
        - Domains
      summary: Deletes a single domain from an account
      operationId: DELETE-v1-inboxready-domains
      parameters:
        - name: domain
          in: query
          description: Domain name
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-DeleteDomainResponse
              examples:
                Example:
                  value:
                    message: domain.tld has been removed from Mailgun Optimize
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v1/inboxready/domains/verify:
    put:
      tags:
        - Domains
      summary: Queues a domain to be processed for verification
      operationId: PUT-v1-inboxready-domains-verify
      parameters:
        - name: domain
          in: query
          description: Domain name
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse
              examples:
                Example:
                  value:
                    message: Domain pending verification
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse
              examples:
                Example:
                  value:
                    message: No domain provided
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse
              examples:
                Example:
                  value:
                    message: Domain not found
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v1/inboxready/ip_addresses:
    get:
      tags:
        - IP Blocklist Monitoring
      summary: Lists monitored IP addresses
      operationId: GET-v1-inboxready-ip-addresses
      parameters:
        - name: limit
          in: query
          description: Limit
          schema:
            type: integer
            default: 100
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-ListIPAddressesResp
              examples:
                Example:
                  value:
                    items:
                      - ip: 127.0.0.1
                        ip_pool: swimming
                        description: this is a description
                        state: listed
                        listed:
                          - list: b.barracudacentral.org
                            delist_requested_at: '0001-01-01T00:00:00Z'
                            first_seen: '2021-06-14T13:46:52Z'
                            last_seen: '2022-06-14T13:46:52Z'
                            comments:
                              - >-
                                http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
    post:
      tags:
        - IP Blocklist Monitoring
      summary: Register an IP address
      operationId: POST-v1-inboxready-ip-addresses
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-CreateIPAddressReq
            examples:
              Example:
                value:
                  UpdateIPAddressReq: {}
        required: true
      responses:
        '201':
          description: A 201 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress
              examples:
                Example:
                  value:
                    - ip: 127.0.0.1
                      ippool: swimming
                      description: this is a description
                      state: listed
                      listed:
                        - list: b.barracudacentral.org
                          delistrequestedat: '0001-01-01T00:00:00Z'
                          firstseen: '2021-06-14T13:46:52Z'
                          lastseen: '2022-06-14T13:46:52Z'
                          comments:
                            - >-
                              http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1
                          name: ''
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
        '409':
          description: A 409 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v1/inboxready/ip_addresses/{ip}:
    get:
      tags:
        - IP Blocklist Monitoring
      summary: Get the IP address
      operationId: GET-v1-inboxready-ip-addresses--ip-
      parameters:
        - name: ip
          in: path
          description: IP address
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress
              examples:
                Example:
                  value:
                    - ip: 127.0.0.1
                      ippool: swimming
                      description: this is a description
                      state: listed
                      listed:
                        - list: b.barracudacentral.org
                          delistrequestedat: '0001-01-01T00:00:00Z'
                          firstseen: '2021-06-14T13:46:52Z'
                          lastseen: '2022-06-14T13:46:52Z'
                          comments:
                            - >-
                              http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1
                          name: ''
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
    put:
      tags:
        - IP Blocklist Monitoring
      summary: Update the IP address
      operationId: PUT-v1-inboxready-ip-addresses--ip-
      parameters:
        - name: ip
          in: path
          description: IP address
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-api-UpdateIPAddressReq
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress
              examples:
                Example:
                  value:
                    - ip: 127.0.0.1
                      ippool: swimming
                      description: this is a description
                      state: listed
                      listed:
                        - list: b.barracudacentral.org
                          delistrequestedat: '0001-01-01T00:00:00Z'
                          firstseen: '2021-06-14T13:46:52Z'
                          lastseen: '2022-06-14T13:46:52Z'
                          comments:
                            - >-
                              http://www.barracudanetworks.com/reputation/?pr=1&ip=127.0.0.1
                          name: ''
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
    delete:
      tags:
        - IP Blocklist Monitoring
      summary: Removes IP from monitoring
      operationId: DELETE-v1-inboxready-ip-addresses--ip-
      parameters:
        - name: ip
          in: path
          description: IP address
          required: true
          schema:
            type: string
      responses:
        '204':
          description: A 204 response
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: description of the error
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: IP Blocklist monitoring not enabled
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: ip address not found
      security:
        - basicAuth: []
  /v1/preview/tests/clients:
    get:
      tags:
        - Email Preview
      summary: List Clients
      description: Returns a list of clients that can perform an email preview.
      operationId: GET-v1-preview-tests-clients
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientsResponse
              examples:
                Example:
                  value:
                    clients:
                      android10_gmailapp_pixel4_dm:
                        id: android10_gmailapp_pixel4_dm
                        client: Gmail App Pixel 4
                        os: Android 10 (Dark Mode)
                        category: Mobile
                        browser: ''
                        rotate: false
                        imageblocking: false
                        free: false
                        default: true
                        extension: ''
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v1/preview/tests:
    get:
      tags:
        - Email Preview
      summary: List Emailpreview Tests
      description: >-
        Returns a list of email preview tests.<br><br>**WARNING:** _This
        endpoint is deprecated in favor of our [V2
        endpoint](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/GET-v2-preview-tests)._
      operationId: GET-v1-preview-tests
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestsResponse
              examples:
                Example:
                  value:
                    - id: ''
                      date: 0
                      type: ''
                      subject: ''
                      headers:
                        '': ''
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      deprecated: true
      security:
        - basicAuth: []
    post:
      tags:
        - Email Preview
      summary: Create Emailpreview Test
      description: >-
        Creates a new email preview test.<br><br>**WARNING:** _This endpoint is
        deprecated in favor of our [V2
        endpoint](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/POST-v2-preview-tests)._
      operationId: POST-v1-preview-tests
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestRequest
            examples:
              Example:
                value:
                  subject: some subject
                  url: https://example.com
                  content_checking: {}
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestResponse
              examples:
                Example:
                  value:
                    id: gmail
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      deprecated: true
      security:
        - basicAuth: []
  /v1/preview/tests/{test_id}/results:
    get:
      tags:
        - Email Preview
      summary: Get Test Results
      description: Returns the results for the specified email preview test.
      operationId: GET-v1-preview-tests--test-id--results
      parameters:
        - name: test_id
          in: path
          description: Test to get results for
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestResultsResponse
              examples:
                Example:
                  value:
                    android10_gmailapp_pixel4_dm:
                      id: android10_gmailapp_pixel4_dm
                      displayname: Gmail App Pixel 4
                      client: Gmail App
                      os: Android 10 (Dark Mode)
                      category: Mobile
                      browser: ''
                      screenshots:
                        default: https://images.emailonacid.com/123
                      thumbnail: https://images.emailonacid.com/1234
                      fullthumbnail: >-
                        https://images.emailonacid.com/90479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257
                      status: Complete
                      statusdetails:
                        submitted: 1741804257
                        completed: 1741804276
                        bouncecode: ''
                        bouncemessage: ''
                    android10_gmailapp_pixel4_lm:
                      id: android10_gmailapp_pixel4_lm
                      displayname: Gmail App Pixel 4
                      client: Gmail App
                      os: Android 10
                      category: Mobile
                      browser: ''
                      screenshots:
                        default: >-
                          https://images.emailonacid.com/YXB479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257
                      thumbnail: >-
                        https://images.emailonacid.com/YXBpLzRRZVp3Z0479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257
                      fullthumbnail: >-
                        https://images.emailonacid.com/YXBpLzRRZVp3ZzlBbmJydjVEZjBUOW9obUxpU1RUQmpe=d90479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257
                      status: Complete
                      statusdetails:
                        submitted: 1741804257
                        completed: 1741804275
                        bouncecode: ''
                        bouncemessage: ''
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v1/preview/tests/{test_id}:
    get:
      tags:
        - Email Preview
      summary: Get Emailpreview Test Info
      description: >-
        Returns test info.<br><br>**WARNING:** _This endpoint is deprecated in
        favor of our [V2
        endpoint](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/GET-v2-preview-tests--test-id-)._
      operationId: GET-v1-preview-tests--test-id-
      parameters:
        - name: test_id
          in: path
          description: Test to get the content of
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestInfoResponse
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      deprecated: true
      security:
        - basicAuth: []
    delete:
      tags:
        - Email Preview
      summary: Delete Emailpreview Test
      description: >-
        Deletes the specified test.<br><br>**WARNING:** _This endpoint is
        deprecated in favor of our [V2
        endpoint](https://documentation.mailgun.com/docs/inspect/api-reference/openapi-final/tag/Email-Preview/#tag/Email-Preview/operation/DELETE-v2-preview-tests--test-id-)._
      operationId: DELETE-v1-preview-tests--test-id-
      parameters:
        - name: test_id
          in: path
          description: Test to delete
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-DeleteTestResponse
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      deprecated: true
      security:
        - basicAuth: []
  /v1/preview/tests/{test_id}/results/reprocess:
    put:
      tags:
        - Email Preview
      summary: Reprocess Emailpreview Test
      description: Reprocesses the test for the passed clients.
      operationId: PUT-v1-preview-tests--test-id--results-reprocess
      parameters:
        - name: test_id
          in: path
          description: Test to reprocess
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessTestResponse
              examples:
                Example: {}
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v1/preview/tests/{test_id}/content:
    get:
      tags:
        - Email Preview
      summary: Get Test Content (empty)
      description: Gets HTML content of the passed test.
      operationId: GET-v1-preview-tests--test-id--content
      parameters:
        - name: test_id
          in: path
          description: Test to get the content of
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestContentResponse
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v1/preview/tests/{test_id}/content/{content}:
    get:
      tags:
        - Email Preview
      summary: Get Test Content
      description: Gets HTML content of the passed test.
      operationId: GET-v1-preview-tests--test-id--content--content-
      parameters:
        - name: test_id
          in: path
          description: Test to get the content of
          required: true
          schema:
            type: string
        - name: content
          in: path
          description: 'Content to get: inlinecss or textonly'
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestContentResponse
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v1/preview/address:
    post:
      tags:
        - Email Preview
      summary: Generate Preview Address
      description: Returns or generates an account's email preview address.
      operationId: POST-v1-preview-address
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-address-PreviewAddressResponse
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Email_Preview_API_string'
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v2/preview/tests:
    get:
      tags:
        - Email Preview
      summary: List/Search Tests V2
      description: >-
        This call returns a list of Email Tests along with metadata about each
        test. Email Tests are stored for 90 days. When query parameters are
        provided, only the tests matching the specified criteria will be
        returned; otherwise, all available tests are returned. The response
        structure remains identical in both cases.
      operationId: GET-v2-preview-tests
      parameters:
        - name: customer_id
          in: query
          description: Filter tests by the provided customer ID.
          schema:
            type: string
        - name: from
          in: query
          description: >-
            The starting point of your test date range. Accepts formats like
            '2025-03-10 17:52:07', Unix timestamp, or 'yesterday'.
          schema:
            type: string
        - name: to
          in: query
          description: >-
            The ending point of your test date range. Accepts formats like
            '2025-03-10 17:52:07', Unix timestamp, or 'yesterday'.
          schema:
            type: string
        - name: subject
          in: query
          description: >-
            The "subject" field of returned tests must contain the exact string.
            This search is case-insensitive.
          schema:
            type: string
        - name: headers
          in: query
          description: >-
            Enterprise users can use this field in a KV array of x-headers
            submitted with the test. This is an AND match, meaning all headers
            must be present to return.
          schema:
            type: string
        - name: results
          in: query
          description: >-
            The number of results to return. Must be between 1 and 200. The
            default value is 50.
          schema:
            type: integer
        - name: page
          in: query
          description: >-
            The page number. If you submit a number higher than the number of
            pages in the data, an empty array will be returned. The default
            value is 1.
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestsResponse
              examples:
                Example:
                  value:
                    - id: DdbNga1MdL3N7sO19v5MAmpOKIqFrLg9cgpCIgS4othXJ
                      date: 1739876826
                      type: email-test
                      subject: subject
                      headers: {}
                    - id: pDdLWjbj3ZbAnHkTbg3QG27mFyoc62OAH1WJXgmb0uNT4
                      date: 1739874606
                      type: email-test
                      subject: ''
                      headers: {}
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
    post:
      tags:
        - Email Preview
      summary: Create Email Preview Test V2
      description: >-
        This call creates a new email test and submits it to our system for
        processing.<br>All requests must contain a subject property and one
        source property (either html or url). All other properties are optional.
        In the following table, each property and its default value is shown.
        <br>If content-checking variables (such as those for link validation,
        image validation, or accessibility) are set in the body of the request,
        the endpoint will run content-checking on the email content. <br>The
        response will include an id property that should be used to request the
        results or trigger further processes on the email content.<br>For
        enterprise customers, the response will also include the customer_id and
        reference_id that were submitted with the test.
      operationId: POST-v2-preview-tests
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestRequest
            examples:
              Example:
                value:
                  subject: Example subject
                  html: <html>...</html>
                  transfer_encoding: base64
                  charset: utf-8
                  customer_id: '1'
                  clients:
                    - client1
                    - client2
                  content_checking:
                    link_validation: true
                    image_validation: true
                    accessibility: true
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestResponse
              examples:
                Example:
                  value:
                    id: exampleTestID
                    customer_id: '1'
                    warnings:
                      - name: InvalidClient
                        message: >-
                          A client ID you have requested (ipadpro_11_15,
                          ipadpro_12_15, iphonese2_15, iphone11pro_15,
                          iphone12promax_15, iphone13promax_15) could not be
                          found. It may be that the code does not exist or that
                          it is no longer supported.
                    content_checking:
                      link_validation:
                        items:
                          id: 67b469d74b911fa30a4d782e
                          links:
                            self: /v1/inspect/links/67b469d74b911fa30a4d782e
                      image_validation:
                        items:
                          id: 67b469d74b911fa30a4d782e
                          links:
                            self: /v1/inspect/images/67b469d74b911fa30a4d782e
                      accessibility:
                        items:
                          id: 67b469d74b911fa30a4d782e
                          links:
                            self: /v1/inspect/accessibility/67b469d74b911fa30a4d782e
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v2/preview/tests/{test_id}/results/{client_id}:
    get:
      tags:
        - Email Preview
      summary: Get Test Results by client ID V2
      description: >-
        This call returns detailed results for screenshots including their
        upload locations, send times, completion times, and information about
        bounces, if any. <test_id> is a test ID returned from test creation or
        the get test list functions. The <client_id> is required and restricts
        the returned data exclusively to the specified client. If the client is
        not present in the test or is invalid, an error will be returned.
      operationId: GET-v2-preview-tests--test-id--results--client-id-
      parameters:
        - name: test_id
          in: path
          description: Test to get results for
          required: true
          schema:
            type: string
        - name: client_id
          in: path
          description: Client to get results for
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestResultsResponse
              examples:
                Example:
                  value:
                    android10_gmailapp_pixel4_dm:
                      id: android10_gmailapp_pixel4_dm
                      displayname: Gmail App Pixel 4
                      client: Gmail App
                      os: Android 10 (Dark Mode)
                      category: Mobile
                      browser: ''
                      screenshots:
                        default: https://images.emailonacid.com/123
                      thumbnail: https://images.emailonacid.com/1234
                      fullthumbnail: >-
                        https://images.emailonacid.com/90479d4733fc5f409475644cb01384b0b21bc53f1c32e0ed609756dfb63d2f5%3A1741804257
                      status: Complete
                      statusdetails:
                        submitted: 1741804257
                        completed: 1741804276
                        bouncecode: ''
                        bouncemessage: ''
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v2/preview/tests/{test_id}:
    get:
      tags:
        - Email Preview
      summary: Get Emailpreview Test Information V2
      description: >-
        Retrieves detailed information about a specific test, including the
        subject, submission time (in UNIX timestamp format), processing
        statuses, and any content checking results. The response includes one to
        three properties containing arrays of clients: completed (clients that
        have successfully uploaded screenshots), processing (clients that are
        still being processed by our system), and bounced (clients that were
        bounced by the destination and cannot be retried). Additionally, the
        system will automatically requeue screenshots if they remain in
        processing for more than three minutes.
      operationId: GET-v2-preview-tests--test-id-
      parameters:
        - name: test_id
          in: path
          description: The ID of the test to retrieve
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestInfoResponse
              examples:
                Example:
                  value:
                    subject: Example Subject
                    date: 1739876826
                    completed:
                      - client1
                    processing:
                      - client2
                    bounced:
                      - client3
                    content_checking:
                      link_validation:
                        items:
                          links: {}
                      image_validation:
                        items:
                          id: 67b469d74b911fa30a4d782e
                          links:
                            self: /v1/inspect/images/67b469d74b911fa30a4d782e
                      accessibility:
                        items:
                          links: {}
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
    delete:
      tags:
        - Email Preview
      summary: Delete Emailpreview Test V2
      description: >-
        Deletes the specified test and its content checking. Once it is deleted,
        it cannot be recovered.
      operationId: DELETE-v2-preview-tests--test-id-
      parameters:
        - name: test_id
          in: path
          description: Test to delete
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-DeleteTestResponse
              examples:
                Example:
                  value:
                    success: true
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v2/preview/tests/{test_id}/exports/{job_id}:
    get:
      tags:
        - Email Preview
      summary: Retrieve Export Job Details for Email Preview Test Screenshots
      description: >-
        Retrieves the status and details of an export job created to collect
        screenshots for an Email Preview Test. Provide both the test ID and the
        job ID to fetch the export job information.
      operationId: GET-v2-preview-tests--test-id--exports--job-id-
      parameters:
        - name: test_id
          in: path
          description: Unique identifier of the Email Preview Test
          required: true
          schema:
            type: string
        - name: job_id
          in: path
          description: Unique identifier of the export job
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking
              examples:
                Example:
                  value:
                    job_id: 67b469d74b911fa30a4d782e
                    test_id: 98b469d74b956fa30a4d125f
                    clients:
                      - android11_gmailapp_pixel5_dm
                      - android12_gmailapp_pixel6_dm
                    job_status: Completed
                    zip_url: https://example.com/export.zip
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v2/preview/tests/{test_id}/exports:
    get:
      tags:
        - Email Preview
      summary: Retrieve Export Job Details for Email Preview Test Screenshots
      description: >-
        Retrieves the status and details of an export job created to collect
        screenshots for an Email Preview Test. Provide the test ID to fetch the
        latest export job information.
      operationId: GET-v2-preview-tests--test-id--exports
      parameters:
        - name: test_id
          in: path
          description: Unique identifier of the Email Preview Test
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking
              examples:
                Example:
                  value:
                    job_id: 67b469d74b911fa30a4d782e
                    test_id: 98b469d74b956fa30a4d125f
                    clients:
                      - android11_gmailapp_pixel5_dm
                      - android12_gmailapp_pixel6_dm
                    job_status: Completed
                    zip_url: https://example.com/export.zip
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
    post:
      tags:
        - Email Preview
      summary: Create Export Job for Email Preview Test Screenshots
      description: >-
        Initiates an export job that collects screenshots for a specified Email
        Preview Test. Provide the list of client IDs whose screenshots you want
        to export. The job status can be monitored using the job ID returned in
        the response.
      operationId: POST-v2-preview-tests--test-id--exports
      parameters:
        - name: test_id
          in: path
          description: >-
            Unique identifier of the Email Preview Test to export screenshots
            for
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateZipExport
            examples:
              Example:
                value:
                  clients:
                    - android11_gmailapp_pixel5_dm
                    - android12_gmailapp_pixel6_dm
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking
              examples:
                Example:
                  value:
                    job_id: 67b469d74b911fa30a4d782e
                    test_id: 98b469d74b956fa30a4d125f
                    clients:
                      - android11_gmailapp_pixel5_dm
                      - android12_gmailapp_pixel6_dm
                    job_status: Processing
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '401':
          description: A 401 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse
      security:
        - basicAuth: []
  /v1/preview/sharing:
    post:
      tags:
        - Email Preview
      summary: Create PreviewShare
      description: Create a shareable link to an email preview test.
      operationId: POST-v1-preview-sharing
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-api-CreatePreviewSharingRequest
            examples:
              Example:
                value:
                  test_id: some-id
        required: true
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: record created
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v1/preview/sharing/{test_id}:
    get:
      tags:
        - Email Preview
      summary: Get PreviewShare
      description: Returns PreviewShare record by TID.
      operationId: GET-v1-preview-sharing--test-id-
      parameters:
        - name: test_id
          in: path
          description: Test to get
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-sharing-PreviewSharingResponse
              examples:
                Example:
                  value:
                    test_id: some-test-id
                    url_uuid: some-uuid
                    url: share.mailgun.com/email-previews/some-uuid
                    enabled: true
                    expires_at: 0001-01-01 00:00:00 +0000 UTC
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
    put:
      tags:
        - Email Preview
      summary: Update PreviewShare
      description: Updates PreviewShare record enabled field.
      operationId: PUT-v1-preview-sharing--test-id-
      parameters:
        - name: test_id
          in: path
          description: Test to update
          required: true
          schema:
            type: string
        - name: url_uuid
          in: query
          description: UUID to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: record updated
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
    delete:
      tags:
        - Email Preview
      summary: Delete PreviewShare
      description: Delete PreviewShare record by TID.
      operationId: DELETE-v1-preview-sharing--test-id-
      parameters:
        - name: test_id
          in: path
          description: Test to delete
          required: true
          schema:
            type: string
        - name: url_uuid
          in: query
          description: UUID to delete
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: record deleted
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v1/preview/sharing/{test_id}/rotate:
    post:
      tags:
        - Email Preview
      summary: Rotate PreviewShare
      description: Re-generates the uuid and share url, and resets the expiration.
      operationId: POST-v1-preview-sharing--test-id--rotate
      parameters:
        - name: test_id
          in: path
          description: Test to rotate
          required: true
          schema:
            type: string
        - name: url_uuid
          in: query
          description: UUID to rotate
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-sharing-PreviewSharingResponse
              examples:
                Example:
                  value:
                    test_id: some-test-id
                    url_uuid: some-new-uuid
                    url: share.mailgun.com/email-previews/some-new-uuid
                    enabled: true
                    expires_at: 0001-01-01 00:00:00 +0000 UTC
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v1/preview/sharing/public/{id}:
    get:
      tags:
        - Email Preview
      summary: Returns PreviewShare record by UUID.
      operationId: GET-v1-preview-sharing-public--id-
      parameters:
        - name: id
          in: path
          description: UUID to get
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-api-PreviewTestResultsResponse
              examples:
                Example:
                  value:
                    subject: some test
                    date: 1
                    results: []
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse
        4xx:
          description: A 4xx response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError
      security:
        - basicAuth: []
  /v1/monitoring/domains:
    get:
      tags:
        - Domain Blocklist Monitoring
      summary: Get Monitored Domains
      description: Gets all domains that are being monitored for blocklisting
      operationId: api.(*HealthController).GetMonitoredDomainsRecords-fm-5
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_DomainsResponse
              examples:
                Example:
                  value:
                    domains:
                      - domain: yourdomain.com
                        state: heathly
                        updated_at: 2023-09-06 18:45:51 +0000 UTC
                      - domain: yourotherdomain.com
                        listed:
                          - first_seen: 2023-01-02 02:14:27 +0000 UTC
                            last_seen: 2023-09-06 18:45:51 +0000 UTC
                            list: dbl.spamhaus.org
                            name: Spamhaus DBL
                        state: listed
                        updated_at: 2023-09-06 18:45:51 +0000 UTC
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse
              examples:
                Example:
                  value:
                    message: reason for bad request
      security:
        - basicAuth: []
  /v1/monitoring/domains/events:
    get:
      tags:
        - Domain Blocklist Monitoring
      summary: Get All Events
      description: Get all events for all domains monitored
      operationId: api.RegisterHealthController.PageHandler.func1-6
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_EventsResponse
              examples:
                Example:
                  value:
                    events:
                      - domain: yourotherdomain.com
                        event: listed
                        list: Spamhaus DBL
                        name: Spamhaus DBL
                        timestamp: 0001-01-01 00:00:00 +0000 UTC
                      - domain: yourdomain.com
                        event: delisted
                        list: Spamhaus DBL
                        name: Spamhaus DBL
                        timestamp: 0001-01-01 00:00:00 +0000 UTC
                      - domain: yourdomain.com
                        event: listed
                        list: Spamhaus DBL
                        name: Spamhaus DBL
                        timestamp: 0001-01-01 00:00:00 +0000 UTC
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse
              examples:
                Example:
                  value:
                    message: reason for bad request
      security:
        - basicAuth: []
  /v1/monitoring/domains/{domain}/blocklists:
    get:
      tags:
        - Domain Blocklist Monitoring
      summary: Get Lists Domain is Listed in
      description: Get blocklists that the domain is listed in
      operationId: api.(*HealthController).GetListedIn-fm-7
      parameters:
        - name: domain
          in: path
          description: The domain name
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_BlocklistResponse
              examples:
                Example:
                  value:
                    blocklists:
                      - comments:
                          - ''
                        first_seen: 2023-01-02 02:14:27 +0000 UTC
                        last_seen: 2023-09-06 18:45:51 +0000 UTC
                        list: Spamhaus DBL
                        name: Spamhaus DBL
                      - comments:
                          - ''
                        first_seen: 2023-01-02 02:14:27 +0000 UTC
                        last_seen: 2023-09-06 18:45:51 +0000 UTC
                        list: SURBL
                        name: SURBL
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse
              examples:
                Example:
                  value:
                    message: reason for bad request
      security:
        - basicAuth: []
  /v1/monitoring/domains/{domain}/events:
    get:
      tags:
        - Domain Blocklist Monitoring
      summary: Get Events for Domain
      description: Get events for a specific domain
      operationId: api.RegisterHealthController.PageHandler.func2-8
      parameters:
        - name: domain
          in: path
          description: The domain name
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_EventsResponse
              examples:
                Example:
                  value:
                    events:
                      - domain: yourdomain.com
                        event: delisted
                        list: Spamhaus DBL
                        name: Spamhaus DBL
                        timestamp: 0001-01-01 00:00:00 +0000 UTC
                      - domain: yourdomain.com
                        event: listed
                        list: Spamhaus DBL
                        name: Spamhaus DBL
                        timestamp: 0001-01-01 00:00:00 +0000 UTC
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Domain_Blocklist_Monitoring_GenericResponse
              examples:
                Example:
                  value:
                    message: reason for bad request
      security:
        - basicAuth: []
  /v1/spamtraps/totals:
    get:
      summary: Get Spam Trap Hits Total
      operationId: GET-v1-spamtraps-totals
      parameters:
        - name: start
          in: query
          description: >-
            The start date in UTC (format YYYY-MM-DD) of the timeframe for which
            you wish to see data.
          required: true
          schema:
            type: string
        - name: end
          in: query
          description: >-
            The end date in UTC (format YYYY-MM-DD) of the timeframe for which
            you wish to see data.
          required: true
          schema:
            type: string
        - name: sortby
          in: query
          description: >-
            Acceptable values include date, totals, domain, subject, ip, and
            from. Defaults to date.
          schema:
            type: string
        - name: groupby
          in: query
          description: >-
            Use this field to group results. Acceptable values include domain,
            subject, ip, and from.
          schema:
            type: string
        - name: subject
          in: query
          description: Use this field to filter results by email subject.
          schema:
            type: string
        - name: domain
          in: query
          description: Use this field to filter results by domain(s).
          schema:
            type: string
        - name: ip
          in: query
          description: Use this field to filter results by ip(s).
          schema:
            type: string
        - name: from
          in: query
          description: Use this field to filter results by sender email address.
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-GroupedTotalsResponse
              examples:
                Example:
                  value:
                    paging: {}
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse
      tags:
        - openapi-spamtraps_other
      security:
        - basicAuth: []
  /v1/spamtraps/filters:
    get:
      summary: Get Spam Trap Filters
      description: >-
        Get a list of domain, ip, subject, From that hit spamtraps, like
        spamtraps totals but no counts
      operationId: GET-v1-spamtraps-filters
      parameters:
        - name: start
          in: query
          description: >-
            The start date in UTC (format YYYY-MM-DD) of the timeframe for which
            you wish to see data.
          required: true
          schema:
            type: string
        - name: end
          in: query
          description: >-
            The end date in UTC (format YYYY-MM-DD) of the timeframe for which
            you wish to see data.
          required: true
          schema:
            type: string
        - name: sortby
          in: query
          description: >-
            Acceptable values include date, totals, domain, subject, ip, and
            from. Defaults to date.
          schema:
            type: string
        - name: groupby
          in: query
          description: >-
            Use this field to group results. Acceptable values include domain,
            subject, ip, and from.
          schema:
            type: string
        - name: subject
          in: query
          description: Use this field to filter results by email subject.
          schema:
            type: string
        - name: domain
          in: query
          description: Use this field to filter results by domain(s).
          schema:
            type: string
        - name: ip
          in: query
          description: Use this field to filter results by ip(s).
          schema:
            type: string
        - name: from
          in: query
          description: Use this field to filter results by sender email address.
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-FiltersResponse
              examples:
                Example:
                  value:
                    items:
                      - example.com
                      - domain.com
                    paging: {}
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse
      tags:
        - openapi-spamtraps_other
      security:
        - basicAuth: []
  /v1/spamtraps:
    get:
      tags:
        - Spam Traps Monitoring
      summary: Get Spam Trap Hits
      description: >-
        Use this endpoint to understand how much of your mail being sent to
        known spam traps. This endpoint returns daily spam trap hit counts for a
        provided timerange, categorized by trap type.
      operationId: GET-v1-spamtraps
      parameters:
        - name: start
          in: query
          description: >-
            The start date in UTC (format YYYY-MM-DD) of the timeframe for which
            you wish to see data.
          required: true
          schema:
            type: string
        - name: end
          in: query
          description: >-
            The end date in UTC (format YYYY-MM-DD) of the timeframe for which
            you wish to see data.
          required: true
          schema:
            type: string
        - name: sortby
          in: query
          description: >-
            Acceptable values include date, totals, domain, subject, ip, and
            from. Defaults to date.
          schema:
            type: string
        - name: groupby
          in: query
          description: >-
            Use this field to group results. Acceptable values include domain,
            subject, ip, and from.
          schema:
            type: string
        - name: subject
          in: query
          description: Use this field to filter results by email subject.
          schema:
            type: string
        - name: domain
          in: query
          description: Use this field to filter results by domain(s).
          schema:
            type: string
        - name: ip
          in: query
          description: Use this field to filter results by ip(s).
          schema:
            type: string
        - name: from
          in: query
          description: Use this field to filter results by sender email address.
          schema:
            type: string
        - name: limit
          in: query
          description: Limits the number of items returned in a request
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-DatedTotalsResponse
              examples:
                Example:
                  value:
                    items:
                      - date: '2022-01-01'
                        pristine: 34
                        recycled: 258
                        typo: 178
                        total: 470
                      - date: '2022-01-02'
                        pristine: 32
                        recycled: 75
                        typo: 150
                        total: 257
                    paging: {}
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: reason for bad request
      security:
        - basicAuth: []
  /v4/inbox/seedlists:
    get:
      tags:
        - Inbox Placement
      summary: List Seed Lists
      operationId: GET-v4-inbox-seedlists
      parameters:
        - name: time_after
          in: query
          schema:
            type: string
        - name: time_before
          in: query
          schema:
            type: string
        - name: name
          in: query
          schema:
            type: string
        - name: cursor
          in: query
          schema:
            type: string
        - name: sort
          in: query
          schema:
            type: string
        - name: offset
          in: query
          schema:
            type: integer
        - name: ascending
          in: query
          schema:
            type: boolean
        - name: limit
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example:
                  value:
                    items:
                      - kid: ''
                        id: ''
                        accountid: ''
                        createdat: '0001-01-01T00:00:00Z'
                        updatedat: '0001-01-01T00:00:00Z'
                        lastresult: '0001-01-01T00:00:00Z'
                        targetemail: ''
                        sendingdomains: []
                        touched: false
                        testprefix: ''
                        seedfilter: ''
                        providerfilter: []
                        mailinglist: ''
                        previousmailinglist: ''
                        createdts: 0
                        tags: {}
                        stats: {}
                        seedquality: 0
                        isautogenerated: false
                        version: 0
                        originseedsemails: []
                        regenneeded: false
                        regenat: '0001-01-01T00:00:00Z'
                    total: 1
      security:
        - basicAuth: []
    post:
      tags:
        - Inbox Placement
      summary: Generate a New Seed List
      operationId: POST-v4-inbox-seedlists
      parameters:
        - name: sending_domains
          in: query
          description: Deprecated.
          schema:
            type: string
        - name: name
          in: query
          schema:
            type: string
        - name: provider_filter
          in: query
          description: Array of provider domains. Omitting means all providers.
          schema:
            type: string
        - name: remote_id
          in: query
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-KeyBox
              examples:
                Example:
                  value:
                    created_at: 0001-01-01 00:00:00 +0000 UTC
                    updated_at: 0001-01-01 00:00:00 +0000 UTC
                    last_result_at: 0001-01-01 00:00:00 +0000 UTC
                    regen_at: 0001-01-01 00:00:00 +0000 UTC
      security:
        - basicAuth: []
  /v4/inbox/seedlists/a:
    get:
      tags:
        - Inbox Placement
      summary: List Available Attributes for Seed Lists
      operationId: GET-v4-inbox-seedlists-a
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
      security:
        - basicAuth: []
  /v4/inbox/seedlists/a/{attribute}:
    get:
      tags:
        - Inbox Placement
      summary: Get List of Values for Seed List Attribute
      operationId: GET-v4-inbox-seedlists-a--attribute-
      parameters:
        - name: attribute
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
      security:
        - basicAuth: []
  /v4/inbox/seedlists/_filters:
    get:
      tags:
        - Inbox Placement
      summary: Get List of Available Seed List Filters
      operationId: GET-v4-inbox-seedlists--filters
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
      security:
        - basicAuth: []
  /v4/inbox/seedlists/{address}:
    get:
      tags:
        - Inbox Placement
      summary: Get Seed List
      operationId: GET-v4-inbox-seedlists--address-
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError
      security:
        - basicAuth: []
    put:
      tags:
        - Inbox Placement
      summary: Update Seed List
      operationId: PUT-v4-inbox-seedlists--address-
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
        - name: name
          in: query
          schema:
            type: string
        - name: provider_filter
          in: query
          description: Array of provider domains. Omitting means no changes.
          schema:
            type: string
        - name: regen
          in: query
          description: Regenerate the mailing_list.
          schema:
            type: boolean
        - name: sending_domains
          in: query
          description: Deprecated.
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-KeyBox
              examples:
                Example:
                  value:
                    created_at: 0001-01-01 00:00:00 +0000 UTC
                    updated_at: 0001-01-01 00:00:00 +0000 UTC
                    last_result_at: 0001-01-01 00:00:00 +0000 UTC
                    regen_at: 0001-01-01 00:00:00 +0000 UTC
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError
      security:
        - basicAuth: []
    delete:
      tags:
        - Inbox Placement
      summary: Delete a Seed List
      operationId: DELETE-v4-inbox-seedlists--address-
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError
      security:
        - basicAuth: []
  /v4/inbox/results:
    get:
      tags:
        - Inbox Placement
      summary: List Results
      description: Get the details for all placement test results.
      operationId: GET-v4-inbox-results
      parameters:
        - name: sender
          in: query
          schema:
            type: string
        - name: subject
          in: query
          schema:
            type: string
        - name: provider
          in: query
          schema:
            type: string
        - name: target_email
          in: query
          schema:
            type: string
        - name: time_after
          in: query
          schema:
            type: string
        - name: time_before
          in: query
          schema:
            type: string
        - name: cursor
          in: query
          schema:
            type: string
        - name: sort
          in: query
          schema:
            type: string
        - name: offset
          in: query
          schema:
            type: integer
        - name: ascending
          in: query
          schema:
            type: boolean
        - name: limit
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example:
                  value:
                    items:
                      - basictestresult:
                          rid: ''
                          id: ''
                          accountid: ''
                          keyboxid: ''
                          keyboxemail: ''
                          subject: ''
                          sender: ''
                          prefix: ''
                          createdat: '0001-01-01T00:00:00Z'
                          updatedat: '0001-01-01T00:00:00Z'
                          status: ''
                          createdts: 0
                          headers: {}
                          campaignid: ''
                          sharingenabled: false
                          sharingid: ''
                          sharingexpiry: '0001-01-01T00:00:00Z'
                        box:
                          kid: ''
                          id: ''
                          accountid: ''
                          createdat: '0001-01-01T00:00:00Z'
                          updatedat: '0001-01-01T00:00:00Z'
                          lastresult: '0001-01-01T00:00:00Z'
                          targetemail: ''
                          sendingdomains: []
                          touched: false
                          testprefix: ''
                          seedfilter: ''
                          providerfilter: []
                          mailinglist: ''
                          previousmailinglist: ''
                          createdts: 0
                          tags: {}
                          stats: {}
                          seedquality: 0
                          isautogenerated: false
                          version: 0
                          originseedsemails: []
                          regenneeded: false
                          regenat: '0001-01-01T00:00:00Z'
                        seedresults: []
                        spamassassin:
                          isspam: false
                          score: 0
                          required: 0
                          rules: []
                        stats: {}
                        storagekey: ''
                        body: ''
                    total: 1
      security:
        - basicAuth: []
  /v4/inbox/results/a:
    get:
      tags:
        - Inbox Placement
      summary: List Available Attributes for Results
      description: The attributes that can have values listed (for autocomplete).
      operationId: GET-v4-inbox-results-a
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
      security:
        - basicAuth: []
  /v4/inbox/results/a/{attribute}:
    get:
      tags:
        - Inbox Placement
      summary: Get List of Values for a Result Attribute
      description: For the given attribute list the known values (for autocomplete).
      operationId: GET-v4-inbox-results-a--attribute-
      parameters:
        - name: attribute
          in: path
          required: true
          schema:
            type: string
        - name: sender
          in: query
          schema:
            type: string
        - name: subject
          in: query
          schema:
            type: string
        - name: provider
          in: query
          schema:
            type: string
        - name: target_email
          in: query
          schema:
            type: string
        - name: time_after
          in: query
          schema:
            type: string
        - name: time_before
          in: query
          schema:
            type: string
        - name: cursor
          in: query
          schema:
            type: string
        - name: sort
          in: query
          schema:
            type: string
        - name: offset
          in: query
          schema:
            type: integer
        - name: ascending
          in: query
          schema:
            type: boolean
        - name: limit
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
      security:
        - basicAuth: []
  /v4/inbox/results/_filters:
    get:
      tags:
        - Inbox Placement
      summary: List available filters for Results
      description: The filters that can be used when querying for results.
      operationId: GET-v4-inbox-results--filters
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
      security:
        - basicAuth: []
  /v4/inbox/results/{result}:
    get:
      tags:
        - Inbox Placement
      summary: Get Result Details
      description: Get the details for a single result.
      operationId: GET-v4-inbox-results--result-
      parameters:
        - name: result
          in: path
          required: true
          schema:
            type: string
        - name: provider
          in: query
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-Response
              examples:
                Example: {}
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
    delete:
      tags:
        - Inbox Placement
      summary: Delete Result
      description: Delete the result and all associated information.
      operationId: DELETE-v4-inbox-results--result-
      parameters:
        - name: result
          in: path
          required: true
          schema:
            type: string
        - name: provider
          in: query
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v4/inbox/sharing/{result}:
    get:
      tags:
        - Inbox Placement
      summary: Get Result Sharing Status
      description: The sharing status of a result.
      operationId: GET-v4-inbox-sharing--result-
      parameters:
        - name: result
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-ResultSharingInfo
              examples:
                Example:
                  value:
                    expires_at: 0001-01-01 00:00:00 +0000 UTC
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
    put:
      tags:
        - Inbox Placement
      summary: Update Result Sharing Status
      description: Change the sharing status of a result or create a new share URL
      operationId: PUT-v4-inbox-sharing--result-
      parameters:
        - name: result
          in: path
          required: true
          schema:
            type: string
        - name: enabled
          in: query
          required: true
          schema:
            type: boolean
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-ResultSharingInfo
              examples:
                Example:
                  value:
                    expires_at: 0001-01-01 00:00:00 +0000 UTC
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v4/inbox/sharing/public/{shareid}:
    get:
      tags:
        - Inbox Placement
      summary: Get Result by a Share ID
      description: Get a result by the share ID.
      operationId: GET-v4-inbox-sharing-public--shareid-
      parameters:
        - name: shareid
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-TestResult
              examples:
                Example:
                  value:
                    BasicTestResult:
                      created_at: 0001-01-01 00:00:00 +0000 UTC
                      updated_at: 0001-01-01 00:00:00 +0000 UTC
                      sharing_expires_at: 0001-01-01 00:00:00 +0000 UTC
                    spamassassin: {}
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v4/inbox/tests:
    post:
      tags:
        - Inbox Placement
      summary: Run Inbox Placement Test
      description: >-
        Create and run a new inbox placement test. 


        Either 'html' or 'template_name' field should be provided.


        'variables' are [Template
        variables](https://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/#templates),

        which could be used in html or template.

        You can use next recipient variables inside Template variables, 

        which will be filled for every seed automatically:

        %recipient.first_name%, %recipient.last_name%.
      operationId: POST-v4-inbox-tests
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-CreateTestReq
            examples:
              Example:
                value:
                  from: First Last <mail@example.com>
                  subject: Buy our elephants
                  html: >-
                    <html><body>Hello {{first_name}} {{last_name}}. Visit our
                    new shop at {{address}}. <b>Our elephants are the best.</b>
                    </body></html>
                  template_name: template1
                  variables:
                    address: 108, Robinson Ave, Richmond
                    first_name: '%recipient.first_name%'
                    last_name: '%recipient.last_name%'
                  seed_list: ibp-123@mailgun.com
                  provider_filter:
                    - gmail.com
                    - hotmail.com
        required: true
      responses:
        '202':
          description: A 202 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-SpyCreateTestResp
              examples:
                Example:
                  value:
                    result_id: uuid4
                    links:
                      results: https://api.mailgun.net/v4/inbox/results/uuid4
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse
      security:
        - basicAuth: []
  /v4/inbox/providers:
    get:
      tags:
        - Inbox Placement
      summary: List Email Providers
      description: List all available email providers.
      operationId: GET-v4-inbox-providers
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-ListProvidersResp
              examples:
                Example:
                  value:
                    items:
                      - PublicProvider:
                          domain: example.com
                          display_name: Example
                          region: Global
                          created_at: 0001-01-01 00:00:00 +0000 UTC
                          updated_at: 0001-01-01 00:00:00 +0000 UTC
                        unsupported_authentications: {}
      security:
        - basicAuth: []
  /v1/maverick-score/total:
    get:
      tags:
        - Email Health Score
      summary: Get Email Health score and rates for account and subaccounts
      operationId: GET-v1-maverick-score-total
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-GetScoreResp
              examples:
                Example:
                  value:
                    score: 37
                    rates:
                      bounce_rate: 9
                      complaint_rate: 19
                      trap_rate: 3
                      full_mailbox_rate: 3
                      bad_failure_rate: 29
                    counters:
                      delivered: 100500
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError
              examples:
                Example:
                  value:
                    Reason: Subscribe to an Mailgun Optimize plan
        '422':
          description: A 422 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError
              examples:
                Example:
                  value:
                    Reason: reason
      security:
        - basicAuth: []
  /v1/maverick-score/grouped:
    get:
      tags:
        - Email Health Score
      summary: List Email Health score and rates grouped by domains/ips/subaccounts
      description: >-
        Show domains/ips/subdomains that sent more than 10,000 messages and have
        at least one delivery.
      operationId: GET-v1-maverick-score-grouped
      parameters:
        - name: skip
          in: query
          description: Skips N items in a response.
          schema:
            type: integer
            default: 0
        - name: limit
          in: query
          description: Limits the number of items returned in a response.
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 10
        - name: group
          in: query
          description: The key to group score by.
          schema:
            type: string
            enum:
              - domain
              - ip
              - subaccount
            default: domain
            x-enumDescriptions:
              domain: Group by domain
              ip: Group by IP
              subaccount: Group by subaccount
        - name: query
          in: query
          description: 'Query filter, e.g.: ''domain:example.com'''
          schema:
            type: string
        - name: sort
          in: query
          description: >-
            Supports the following syntax 'sort=field:direction'. 'direction'
            must be one of asc, desc. Default 'direction' is asc.
          schema:
            type: string
            enum:
              - domain:asc
              - domain:desc
              - ip:asc
              - ip:desc
              - subaccount:asc
              - subaccount:desc
              - score:asc
              - score:desc
              - bounce_rate:asc
              - bounce_rate:desc
              - complaint_rate:asc
              - complaint_rate:desc
              - trap_rate:asc
              - trap_rate:desc
              - full_mailbox_rate:asc
              - full_mailbox_rate:desc
              - bad_failure_rate:asc
              - bad_failure_rate:desc
              - delivered:asc
              - delivered:desc
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-ListScoreResp
              examples:
                Example:
                  value:
                    items:
                      - group_key: a.example.com
                        score: 37
                        rates:
                          bounce_rate: 9
                          complaint_rate: 19
                          trap_rate: 3
                          full_mailbox_rate: 3
                          bad_failure_rate: 29
                        counters:
                          delivered: 100500
                    total: 1
        '403':
          description: A 403 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError
              examples:
                Example:
                  value:
                    Reason: Subscribe to an Mailgun Optimize plan
      security:
        - basicAuth: []
  /v1/reputationanalytics/gtoken:
    get:
      operationId: GET-v1-reputationanalytics-gtoken
      responses: {}
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
    delete:
      operationId: DELETE-v1-reputationanalytics-gtoken
      responses: {}
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
    patch:
      operationId: PATCH-v1-reputationanalytics-gtoken
      responses: {}
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/domains/{domain}:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Domain
      description: >-
        Returns domain records for a single domain on the account. Each domain
        record is for a single domain on a single day.
      operationId: GET-v1-reputationanalytics-gpt-domains--domain-
      parameters:
        - name: domain
          in: path
          required: true
          schema:
            type: string
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainResponse
              examples:
                Example:
                  value:
                    domain: test.com
                    data:
                      - name: test.com
                        date: 0001-01-01 00:00:00 +0000 UTC
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/domains:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Domains
      description: >-
        Returns a list of all domain records for an account. Each domain record
        is for a single domain on a single day.
      operationId: GET-v1-reputationanalytics-gpt-domains
      parameters:
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainResponse
              examples:
                Example:
                  value:
                    domain: test.com
                    data:
                      - name: test.com
                        date: 0001-01-01 00:00:00 +0000 UTC
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/domainsfbl:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT FBL
      description: Returns the FBL for the account or domain
      operationId: GET-v1-reputationanalytics-gpt-domainsfbl
      parameters:
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainFBLResponse
              examples:
                Example:
                  value:
                    data:
                      - name: test.com
                        id: identifier
                        ratio: 0.001
                        date: 0001-01-01 00:00:00 +0000 UTC
                    total: 1
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/domainsfbl/{domain}:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT FBL
      description: Returns the FBL for the account or domain
      operationId: GET-v1-reputationanalytics-gpt-domainsfbl--domain-
      parameters:
        - name: domain
          in: path
          required: true
          schema:
            type: string
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainFBLResponse
              examples:
                Example:
                  value:
                    data:
                      - name: test.com
                        id: identifier
                        ratio: 0.001
                        date: 0001-01-01 00:00:00 +0000 UTC
                    total: 1
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/addresses/{address}:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Address
      description: >-
        Returns address records for an single address on the account. Each
        address record is for a single address on a single day.
      operationId: GET-v1-reputationanalytics-gpt-addresses--address-
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressResponse
              examples:
                Example:
                  value:
                    address: 0.0.0.0
                    data:
                      - address: 0.0.0.0
                        domain_name: test.com
                        reputation: BAD
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/addresses:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Addresses
      description: >-
        Returns a list of all address records for an account. Each address
        record is for a single address on a single day.
      operationId: GET-v1-reputationanalytics-gpt-addresses
      parameters:
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressResponse
              examples:
                Example:
                  value:
                    address: 0.0.0.0
                    data:
                      - address: 0.0.0.0
                        domain_name: test.com
                        reputation: BAD
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/domains/{domain}/addresses:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Domain Addresses
      description: >-
        Returns a list of all address records for an account belonging to a
        specific domain. Each address record is for a single address on a single
        day.
      operationId: GET-v1-reputationanalytics-gpt-domains--domain--addresses
      parameters:
        - name: domain
          in: path
          required: true
          schema:
            type: string
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainAddressResponse
              examples:
                Example:
                  value:
                    domain: test.com
                    data:
                      - address: 0.0.0.0
                        domain_name: test.com
                        reputation: BAD
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/summary:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Summary
      description: >-
        Returns a list of all summary records for an account. Each record is for
        a single domain's summary and error summary data.
      operationId: GET-v1-reputationanalytics-gpt-summary
      parameters:
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
        - name: sortBy
          in: query
          description: Field name to sort by.
          required: true
          schema:
            type: string
        - name: orderBy
          in: query
          description: '''Asc'' or ''desc'' sorting.'
          required: true
          schema:
            type: string
        - name: searchField
          in: query
          description: 'Value of the domain to search, example: mailgun.com'
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-SummaryResponse
              examples:
                Example:
                  value:
                    summary:
                      - name: test.com
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/summary/domains:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Domains Summary
      description: >-
        Returns a list of all domain summary records for an account. Each record
        is for a single domain's summary data.
      operationId: GET-v1-reputationanalytics-gpt-summary-domains
      parameters:
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
        - name: sortBy
          in: query
          description: Field name to sort by.
          required: true
          schema:
            type: string
        - name: orderBy
          in: query
          description: '''Asc'' or ''desc'' sorting.'
          required: true
          schema:
            type: string
        - name: searchField
          in: query
          description: 'Value of the domain to search, example: mailgun.com'
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainSummaryResponse
              examples:
                Example:
                  value:
                    summary:
                      - name: test.com
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/summary/errors:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Domains Error Summary
      description: >-
        Returns a list of all domain error summary records for an account. Each
        record is for a single domain's error summary data.
      operationId: GET-v1-reputationanalytics-gpt-summary-errors
      parameters:
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
        - name: sortBy
          in: query
          description: Field name to sort by.
          required: true
          schema:
            type: string
        - name: orderBy
          in: query
          description: '''Asc'' or ''desc'' sorting.'
          required: true
          schema:
            type: string
        - name: searchField
          in: query
          description: 'Value of the domain to search, example: mailgun.com'
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainErrorSummaryResponse
              examples:
                Example:
                  value:
                    summary:
                      - name: test.com
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/gpt/summary/addresses:
    get:
      tags:
        - Google Postmaster Tools
      summary: Get GPT Addresses Summary
      description: >-
        Returns a list of all address summary records for an account. Each
        record is for a single address's summary data.
      operationId: GET-v1-reputationanalytics-gpt-summary-addresses
      parameters:
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: offset
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: limit
          in: query
          description: The number of records to return.
          required: true
          schema:
            type: integer
        - name: timeRangeStart
          in: query
          description: Unix timestamp starting time filter.
          required: true
          schema:
            type: integer
        - name: timeRangeEnd
          in: query
          description: Unix timestamp ending time filter.
          required: true
          schema:
            type: integer
        - name: sortBy
          in: query
          description: Field name to sort by.
          required: true
          schema:
            type: string
        - name: orderBy
          in: query
          description: '''Asc'' or ''desc'' sorting.'
          required: true
          schema:
            type: string
        - name: searchField
          in: query
          description: 'Value of the address to search, example: 127.0.0.1'
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressSummaryResponse
              examples:
                Example:
                  value:
                    summary:
                      - domain_name: test.com
                        address: 0.0.0.0
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/snds:
    get:
      operationId: GET-v1-reputationanalytics-snds
      responses: {}
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
    put:
      summary: A test endpoint
      operationId: PUT-v1-reputationanalytics-snds
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
  /v1/reputationanalytics/snds/{ip}:
    get:
      tags:
        - Microsoft SNDS
      summary: Get SNDS Address Info
      description: >-
        Returns a list of all address summary records for an account. Each
        record is for a single address's summary data.
      operationId: GET-v1-reputationanalytics-snds--ip-
      parameters:
        - name: ip
          in: path
          required: true
          schema:
            type: string
        - name: X-Mailgun-Account-Id
          in: header
          description: The account id
          required: true
          schema:
            type: string
        - name: Skip
          in: query
          description: The record number to begin pagination with.
          required: true
          schema:
            type: integer
        - name: SortBy
          in: query
          description: Field name to sort by.
          required: true
          schema:
            type: string
        - name: OrderBy
          in: query
          description: '''asc'' or ''desc'' sorting.'
          required: true
          schema:
            type: string
        - name: Search
          in: query
          description: Value of the address to search
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressSummaryResponse
              examples:
                Example:
                  value:
                    summary:
                      - domain_name: test.com
                        address: 0.0.0.0
        '400':
          description: A 400 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
        '404':
          description: A 404 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError
        '500':
          description: A 500 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse
              examples:
                Example:
                  value:
                    message: Internal Server Error
      security:
        - basicAuth: []
  /v1/reputationanalytics/snds/ip/sync:
    get:
      summary: A test endpoint
      operationId: GET-v1-reputationanalytics-snds-ip-sync
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
    put:
      summary: A test endpoint
      operationId: PUT-v1-reputationanalytics-snds-ip-sync
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
    post:
      summary: A test endpoint
      operationId: POST-v1-reputationanalytics-snds-ip-sync
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
    delete:
      summary: A test endpoint
      operationId: DELETE-v1-reputationanalytics-snds-ip-sync
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
    patch:
      summary: A test endpoint
      operationId: PATCH-v1-reputationanalytics-snds-ip-sync
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
  /v1/reputationanalytics/snds/ip/sync/force:
    post:
      summary: A test endpoint
      operationId: POST-v1-reputationanalytics-snds-ip-sync-force
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
  /v1/reputationanalytics/snds/ip/sync/wipe:
    delete:
      summary: A test endpoint
      operationId: DELETE-v1-reputationanalytics-snds-ip-sync-wipe
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
  /v1/reputationanalytics/snds/ip/sync/update:
    put:
      summary: A test endpoint
      operationId: PUT-v1-reputationanalytics-snds-ip-sync-update
      responses:
        '200':
          description: A 200 response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse
              examples:
                Example:
                  value:
                    items: []
        default:
          description: A default response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError
      tags:
        - openapi-reputationanalytics_other
      security:
        - basicAuth: []
components:
  schemas:
    github.com-mailgun-alerts-internal-api-ListAlertsEventsResp:
      type: object
      properties:
        events:
          type: array
          items:
            type: string
      required:
        - events
    github.com-mailgun-scaffold-httpapi-GenericResponse:
      type: object
      properties:
        message:
          type: string
          description: Response message
      required:
        - message
    github.com-mailgun-alerts-channels-Channel:
      type: string
      enum:
        - email
        - webhook
        - slack
      description: Alert channel type.
    github.com-mailgun-alerts-internal-settings-ChannelSettings:
      type: object
      properties:
        url:
          type: string
          description: For webhook channel.
        emails:
          type: array
          items:
            type: string
          description: For email channel
        channel_ids:
          type: array
          items:
            type: string
          description: For slack channel
    github.com-mailgun-alerts-internal-settings-EventSettings:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier for the alert settings record.
        event_type:
          type: string
          description: >-
            The event type that is alerted on. Check GET /v1/alerts/events for
            possible values.
        channel:
          type: object
          allOf:
            - $ref: '#/components/schemas/github.com-mailgun-alerts-channels-Channel'
          description: The delivery channel for the alert.
        settings:
          type: object
          allOf:
            - $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-settings-ChannelSettings
          description: This object contains channel-specific settings.
        disabled_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Read only. When present
      required:
        - event_type
        - channel
        - settings
    github.com-mailgun-alerts-internal-api-mutateEventSettingReq:
      type: object
      properties:
        event_type:
          type: string
          description: The type of event for which you would like to receive alerts.
        channel:
          type: object
          allOf:
            - $ref: '#/components/schemas/github.com-mailgun-alerts-channels-Channel'
          description: The delivery method for the alert.
        settings:
          type: object
          allOf:
            - $ref: >-
                #/components/schemas/github.com-mailgun-alerts-internal-settings-ChannelSettings
          description: >-
            The details pertaining to the specified channel. Please note that
            the contents of this object differ per channel type.
      required:
        - event_type
        - channel
        - settings
    github.com-mailgun-alerts-internal-settings-Webhooks:
      type: object
      properties:
        signing_key:
          type: string
      required:
        - signing_key
    github.com-mailgun-alerts-internal-settings-Slack:
      type: object
      properties:
        token:
          type: string
        team_id:
          type:
            - string
            - 'null'
        team_name:
          type:
            - string
            - 'null'
        scope:
          type:
            - string
            - 'null'
      required:
        - token
        - team_id
        - team_name
        - scope
    github.com-mailgun-alerts-internal-api-SettingsResponse:
      type: object
      properties:
        events:
          type: array
          items:
            $ref: >-
              #/components/schemas/github.com-mailgun-alerts-internal-settings-EventSettings
        webhooks:
          $ref: >-
            #/components/schemas/github.com-mailgun-alerts-internal-settings-Webhooks
        slack:
          $ref: >-
            #/components/schemas/github.com-mailgun-alerts-internal-settings-Slack
      required:
        - events
        - webhooks
        - slack
    github.com-mailgun-alerts-internal-api-ResetWebhooksSigningKeyResp:
      type: object
      properties:
        signing_key:
          type: string
      required:
        - signing_key
    github.com-mailgun-alerts-internal-api-TestWebhookRequest:
      type: object
      properties:
        event_type:
          type: string
        url:
          type: string
      required:
        - event_type
        - url
    github.com-mailgun-alerts-internal-api-TestEmailRequest:
      type: object
      properties:
        event_type:
          type: string
        emails:
          type: array
          items:
            type: string
      required:
        - event_type
        - emails
    github.com-mailgun-alerts-internal-api-TestSlackRequest:
      type: object
      properties:
        event_type:
          type: string
        channel_ids:
          type: array
          items:
            type: string
          description: If omitted would be taken from the event settings
      required:
        - event_type
    github.com-mailgun-alerts-internal-api-SlackChannel:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        is_archived:
          type: boolean
      required:
        - id
        - name
        - is_archived
    github.com-mailgun-alerts-internal-api-ListSlackChannelsResp:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/github.com-mailgun-alerts-internal-api-SlackChannel
      required:
        - items
    Inbox_Ready_github.com-mailgun-inboxready-model-Verified:
      type: object
      properties:
        verified_at:
          type: integer
          format: int64
        status:
          type: string
      required:
        - verified_at
        - status
    Inbox_Ready_github.com-mailgun-inboxready-model-Domain:
      type: object
      properties:
        created_at:
          type: integer
          format: int64
        name:
          type: string
        verified:
          $ref: >-
            #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-model-Verified
        services:
          type: object
          additionalProperties:
            type: boolean
        txt_record:
          type: string
      required:
        - created_at
        - name
        - verified
        - services
        - txt_record
    Inbox_Ready_github.com-mailgun-scaffold-httpapi-paging-PagingResponse:
      type: object
      properties:
        previous:
          type: string
          description: Previous page URL
        first:
          type: string
          description: First page URL
        next:
          type: string
          description: Next page URL
        last:
          type: string
          description: Last page URL
      required:
        - previous
        - first
        - next
        - last
    Inbox_Ready_github.com-mailgun-inboxready-api-DomainListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-model-Domain
        paging:
          $ref: >-
            #/components/schemas/Inbox_Ready_github.com-mailgun-scaffold-httpapi-paging-PagingResponse
      required:
        - items
    Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericAPIError:
      type: object
      properties:
        Reason:
          type: string
      required:
        - Reason
    Inbox_Ready_github.com-mailgun-inboxready-api-AddDomainResponse:
      type: object
      properties:
        message:
          type: string
        domain:
          $ref: >-
            #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-model-Domain
      required:
        - message
        - domain
    Inbox_Ready_github.com-mailgun-inboxready-api-DeleteDomainResponse:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    Inbox_Ready_github.com-mailgun-inboxready-api-InboxReadyVerifyDomainResponse:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    Inbox_Ready_github.com-mailgun-inboxready-clients-medic-Blacklist:
      type: object
      properties:
        list:
          type: string
        delist_requested_at:
          type: string
          format: date-time
        first_seen:
          type: string
          format: date-time
        last_seen:
          type: string
          format: date-time
        comments:
          type: array
          items:
            type: string
        name:
          type: string
      required:
        - list
        - delist_requested_at
        - last_seen
        - comments
    Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress:
      type: object
      properties:
        ip:
          type: string
        ip_pool:
          type: string
        description:
          type: string
        state:
          type: string
        listed:
          type: array
          items:
            $ref: >-
              #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-Blacklist
      required:
        - ip
        - ip_pool
        - description
        - state
        - listed
    Inbox_Ready_github.com-mailgun-inboxready-api-ListIPAddressesResp:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/Inbox_Ready_github.com-mailgun-inboxready-clients-medic-IPAddress
      required:
        - items
    Inbox_Ready_github.com-mailgun-scaffold-httpapi-GenericResponse:
      type: object
      properties:
        message:
          type: string
          description: Response message
      required:
        - message
    Inbox_Ready_github.com-mailgun-inboxready-api-CreateIPAddressReq:
      type: object
      properties:
        ip:
          type: string
        ip_pool:
          type: string
        description:
          type: string
      required:
        - ip
        - ip_pool
        - description
    Inbox_Ready_github.com-mailgun-inboxready-api-UpdateIPAddressReq:
      type: object
      properties:
        ip_pool:
          type: string
        description:
          type: string
      required:
        - ip_pool
        - description
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientInfo:
      type: object
      properties:
        id:
          type: string
        client:
          type: string
        os:
          type: string
        category:
          type: string
        browser:
          type: string
        rotate:
          type: boolean
        image_blocking:
          type: boolean
        free:
          type: boolean
        default:
          type: boolean
        ext:
          type: string
      required:
        - id
        - client
        - os
        - category
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientsResponse:
      type: object
      properties:
        clients:
          type: object
          additionalProperties:
            $ref: >-
              #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ClientInfo
      required:
        - clients
    Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericAPIError:
      type: object
      properties:
        Reason:
          type: string
      required:
        - Reason
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Error:
      type: object
      properties:
        name:
          type: string
        message:
          type: string
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ErrorResponse:
      type: object
      properties:
        error:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Error
    Email_Preview_API_github.com-mailgun-scaffold-httpapi-GenericResponse:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Warning:
      type: object
      properties:
        name:
          type: string
        message:
          type: string
    Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Links:
      type: object
      properties:
        self:
          type: string
    Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Item:
      type: object
      properties:
        id:
          type: string
        links:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Links
    Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-ErrorDetail:
      type: object
      properties:
        status:
          type: string
        title:
          type: string
        detail:
          type: string
    Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse:
      type: object
      properties:
        items:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-Item
        errors:
          type: array
          items:
            $ref: >-
              #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-ErrorDetail
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult:
      type: object
      properties:
        link_validation:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse
        image_validation:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse
        accessibility:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-inspect-InspectDtoRepsponse
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestResponse:
      type: object
      properties:
        id:
          type: string
        reference_id:
          type: string
        customer_id:
          type: string
        spam:
          type: object
          properties:
            key:
              type: string
            address_list:
              type: array
              items:
                type: string
        warnings:
          type: array
          items:
            $ref: >-
              #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-Warning
        content_checking:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestRequestContentChecking:
      type: object
      properties:
        link_validation:
          type: boolean
        image_validation:
          type: boolean
        accessibility:
          type: boolean
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateTestRequest:
      type: object
      properties:
        subject:
          type: string
        html:
          type: string
        mime:
          type: string
        url:
          type: string
        transfer_encoding:
          type: string
        charset:
          type: string
        reference_id:
          type: string
        customer_id:
          type: string
        clients:
          type: array
          items:
            type: string
        image_blocking:
          type: boolean
        headers:
          type: object
          additionalProperties:
            type: string
        spam:
          type: object
          properties:
            test_method:
              type: string
            from_address:
              type: string
            key:
              type: string
            smtp_info:
              type: object
              properties:
                host:
                  type: string
                port:
                  type: integer
                  format: int32
                secure:
                  type: string
                username:
                  type: string
                password:
                  type: string
        content_checking:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestRequestContentChecking
      required:
        - subject
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestsResponse:
      type: array
      items:
        type: object
        properties:
          id:
            type: string
          date:
            type: integer
            format: int32
          type:
            type: string
          subject:
            type: string
          headers:
            type: object
            additionalProperties:
              type: string
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestResult:
      type: object
      properties:
        id:
          type: string
        display_name:
          type: string
        client:
          type: string
        os:
          type: string
        category:
          type: string
        browser:
          type: string
        screenshots:
          type: object
          additionalProperties:
            type: string
        thumbnail:
          type: string
        full_thumbnail:
          type: string
        status:
          type: string
        status_details:
          type: object
          properties:
            submitted:
              type: integer
              format: int32
            completed:
              type: integer
              format: int32
            bounce_code:
              type: string
            bounce_message:
              type: string
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestResultsResponse:
      type: object
      additionalProperties:
        $ref: >-
          #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestResult
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-DeleteTestResponse:
      type: object
      properties:
        success:
          type: boolean
      required:
        - success
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessInfo:
      type: object
      properties:
        success:
          type: boolean
        remaining_reprocesses:
          type: integer
          format: int32
        regional:
          type: boolean
        screenshot:
          type: object
          properties:
            id:
              type: string
            type:
              type: string
            sent:
              type: integer
              format: int32
            completed:
              type: integer
              format: int32
      required:
        - regional
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessTestResponse:
      type: object
      additionalProperties:
        $ref: >-
          #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ReprocessInfo
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestContentResponse:
      type: object
      properties:
        content:
          type: string
      required:
        - content
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-GetTestInfoResponse:
      type: object
      properties:
        subject:
          type: string
        date:
          type: integer
          format: int32
        completed:
          type: array
          items:
            type: string
        processing:
          type: array
          items:
            type: string
        bounced:
          type: array
          items:
            type: string
        content_checking:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-ContentCheckingResult
      required:
        - subject
        - date
    Email_Preview_API_github.com-mailgun-emailpreview-address-PreviewAddressResponse:
      type: object
      properties:
        preview_address:
          type: string
      required:
        - preview_address
    Email_Preview_API_string:
      type: string
    Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-APIError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
    Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-QueueTracking:
      type: object
      properties:
        job_id:
          type: string
        test_id:
          type: string
        clients:
          type: array
          items:
            type: string
        job_status:
          type: string
        zip_url:
          type: string
        failed_clients:
          type: array
          items:
            type: string
        error:
          $ref: >-
            #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-queue_tracking-APIError
      required:
        - job_id
        - test_id
        - clients
        - job_status
    Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-CreateZipExport:
      type: object
      properties:
        clients:
          type: array
          items:
            type: string
        test_id:
          type: string
      required:
        - clients
        - test_id
    Email_Preview_API_github.com-mailgun-emailpreview-api-CreatePreviewSharingRequest:
      type: object
      properties:
        test_id:
          type: string
      required:
        - test_id
    Email_Preview_API_github.com-mailgun-emailpreview-sharing-PreviewSharingResponse:
      type: object
      properties:
        test_id:
          type: string
        url_uuid:
          type: string
        url:
          type: string
        enabled:
          type: boolean
        expires_at:
          type: string
          format: date-time
      required:
        - test_id
        - url_uuid
        - url
        - enabled
        - expires_at
    Email_Preview_API_github.com-mailgun-emailpreview-api-PreviewTestResultsResponse:
      type: object
      properties:
        subject:
          type: string
        date:
          type: integer
          format: int32
        results:
          type: array
          items:
            $ref: >-
              #/components/schemas/Email_Preview_API_github.com-mailgun-emailpreview-clients-preview-TestResult
      required:
        - subject
        - date
        - results
    Domain_Blocklist_Monitoring_DomainsResponse:
      type: object
      properties:
        domains:
          type: array
          items:
            type: object
            properties:
              domain:
                type: string
              listed:
                type: array
                items:
                  type: object
                  properties:
                    last_seen:
                      type: string
                      format: date-time
                    name:
                      type: string
                    first_seen:
                      type: string
                      format: date-time
                    list:
                      type: string
                    comments:
                      type: array
                      items:
                        type: string
                  required:
                    - list
                    - comments
              updated_at:
                type: string
                format: date-time
              '-':
                type: integer
                format: int64
              state:
                type: string
            required:
              - domain
              - '-'
              - '-'
              - updated_at
              - state
              - listed
      required:
        - domains
    Domain_Blocklist_Monitoring_GenericResponse:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    Domain_Blocklist_Monitoring_paging:
      type: object
      properties:
        first:
          type: string
        previous:
          type: string
        next:
          type: string
        last:
          type: string
      required:
        - previous
        - first
        - next
        - last
    Domain_Blocklist_Monitoring_EventsResponse:
      type: object
      properties:
        events:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              timestamp:
                type: string
                format: date-time
              '-':
                type: string
              domain:
                type: string
              list:
                type: string
              event:
                type: string
            required:
              - timestamp
              - '-'
              - event
              - domain
              - '-'
              - list
        paging:
          $ref: '#/components/schemas/Domain_Blocklist_Monitoring_paging'
      required:
        - events
        - paging
    Domain_Blocklist_Monitoring_BlocklistResponse:
      type: object
      properties:
        blocklists:
          type: array
          items:
            type: object
            properties:
              comments:
                type: array
                items:
                  type: string
              list:
                type: string
              first_seen:
                type: string
                format: date-time
              name:
                type: string
              last_seen:
                type: string
                format: date-time
            required:
              - list
              - comments
      required:
        - blocklists
    Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-GroupedTotals:
      type: object
      properties:
        subject:
          type: string
        domain:
          type: string
        ip:
          type: string
        from:
          type: string
        pristine:
          type: integer
          format: int32
        recycled:
          type: integer
          format: int32
        typo:
          type: integer
          format: int32
        harvested:
          type: integer
          format: int32
        total:
          type: integer
          format: int32
      required:
        - pristine
        - recycled
        - typo
        - harvested
        - total
    Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse:
      type: object
      properties:
        first:
          type: string
        previous:
          type: string
        next:
          type: string
      required:
        - first
        - previous
        - next
    Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-GroupedTotalsResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-GroupedTotals
        paging:
          $ref: >-
            #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse
      required:
        - items
        - paging
    Spamtraps_Analytics_Service_github.com-mailgun-scaffold-httpapi-GenericResponse:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-FiltersResponse:
      type: object
      properties:
        items:
          type: array
          items:
            type: string
        paging:
          $ref: >-
            #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse
      required:
        - items
        - paging
    Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-DatedTotals:
      type: object
      properties:
        date:
          type: string
        pristine:
          type: integer
          format: int32
        recycled:
          type: integer
          format: int32
        typo:
          type: integer
          format: int32
        harvested:
          type: integer
          format: int32
        total:
          type: integer
          format: int32
      required:
        - date
        - pristine
        - recycled
        - typo
        - harvested
        - total
    Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-DatedTotalsResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-model-DatedTotals
        paging:
          $ref: >-
            #/components/schemas/Spamtraps_Analytics_Service_github.com-mailgun-spamtraps-api-PagingResponse
      required:
        - items
        - paging
    Service_Documentation_github.com-mailgun-spy-model-KeyBox:
      type: object
      properties:
        kid:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        last_result_at:
          type: string
          format: date-time
        target_email:
          type: string
        sending_domains:
          type: array
          items:
            type: string
        has_results:
          type: boolean
        name:
          type: string
        seed_filter:
          type: string
        provider_filter:
          type: array
          items:
            type: string
          description: '[] means all providers; null means that only seed_filter is used'
        mailing_list:
          type: string
        previous_mailing_list:
          type: string
          description: List before last regen
        tags:
          type: object
          additionalProperties:
            type: string
        delivery_stats:
          type: object
          additionalProperties:
            type: object
            properties:
              delivered:
                type: integer
                format: int32
              missing:
                type: integer
                format: int32
              pending:
                type: integer
                format: int32
              spam:
                type: integer
                format: int32
              inbox:
                type: integer
                format: int32
              total:
                type: integer
                format: int32
              provider:
                type: string
              categories:
                type: object
                additionalProperties:
                  type: integer
                  format: int32
            required:
              - delivered
              - missing
              - pending
              - spam
              - inbox
              - total
              - provider
              - categories
        is_auto_generated:
          type: boolean
        version:
          type: integer
          format: int32
        regen_needed:
          type: boolean
          description: >-
            Shows that mailing_list has to many unavailable seeds. Only for v2
            Seed List.
        regen_at:
          type: string
          format: date-time
      required:
        - kid
        - created_at
        - updated_at
        - last_result_at
        - target_email
        - sending_domains
        - has_results
        - name
        - seed_filter
        - provider_filter
        - mailing_list
        - previous_mailing_list
        - tags
        - is_auto_generated
        - version
        - regen_needed
        - regen_at
    Service_Documentation_github.com-mailgun-scaffold-httpapi-Response:
      type: object
      additionalProperties:
        type: object
    Service_Documentation_github.com-mailgun-scaffold-httpapi-NotFoundError:
      type: object
      properties:
        Description:
          type: string
      required:
        - Description
    Service_Documentation_github.com-mailgun-scaffold-httpapi-GenericResponse:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    Service_Documentation_github.com-mailgun-spy-model-ResultSharingInfo:
      type: object
      properties:
        result_id:
          type: string
        expires_at:
          type: string
          format: date-time
        enabled:
          type: boolean
        url_id:
          type: string
        url:
          type: string
        api_url:
          type: string
      required:
        - result_id
        - expires_at
        - enabled
        - url_id
        - url
        - api_url
    Service_Documentation_github.com-mailgun-spy-model-MessageHeader:
      type: object
      properties:
        key:
          type: string
        value:
          type: string
      required:
        - key
        - value
    Service_Documentation_github.com-mailgun-spy-spamassassin-Result:
      type: object
      properties:
        is_spam:
          type: boolean
        score:
          type: number
          format: float
        required:
          type: number
          format: float
        rules:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              points:
                type: number
                format: float
              short_description:
                type: string
              long_description:
                type: string
            required:
              - name
              - points
              - short_description
              - long_description
      required:
        - is_spam
        - score
        - required
        - rules
    Service_Documentation_github.com-mailgun-spy-model-TestResult:
      type: object
      properties:
        rid:
          type: string
        result_id:
          type: string
        keybox_email:
          type: string
        subject:
          type: string
        sender:
          type: string
        seedlist_name:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        status:
          type: string
        attributes:
          type: object
          additionalProperties:
            type: string
        campaign_id:
          type: string
        sharing_enabled:
          type: boolean
        sharing_id:
          type: string
        sharing_expires_at:
          type: string
          format: date-time
        seed_results:
          type: array
          items:
            type: object
            properties:
              email:
                type: string
              provider:
                type: string
              destination:
                type: string
              state:
                type: string
              originating_ip:
                type: string
              tags:
                type: array
                items:
                  type: string
              dkim:
                type: string
              spf:
                type: string
              dmarc:
                type: string
              headers:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Service_Documentation_github.com-mailgun-spy-model-MessageHeader
              extensions:
                type: object
                properties:
                  category:
                    type: string
                required:
                  - category
            required:
              - email
              - provider
              - destination
              - state
              - originating_ip
              - tags
              - extensions
        spamassassin:
          $ref: >-
            #/components/schemas/Service_Documentation_github.com-mailgun-spy-spamassassin-Result
        delivery_stats:
          type: object
          additionalProperties:
            type: object
            properties:
              delivered:
                type: integer
                format: int32
              missing:
                type: integer
                format: int32
              pending:
                type: integer
                format: int32
              spam:
                type: integer
                format: int32
              inbox:
                type: integer
                format: int32
              total:
                type: integer
                format: int32
              provider:
                type: string
              categories:
                type: object
                additionalProperties:
                  type: integer
                  format: int32
            required:
              - delivered
              - missing
              - pending
              - spam
              - inbox
              - total
              - provider
              - categories
        body:
          type: string
          description: Only for GET /inbox/results/{result}
      required:
        - rid
        - result_id
        - keybox_email
        - subject
        - sender
        - seedlist_name
        - created_at
        - updated_at
        - status
        - attributes
        - campaign_id
        - sharing_enabled
        - sharing_id
        - sharing_expires_at
        - seed_results
        - spamassassin
        - delivery_stats
        - body
    Service_Documentation_github.com-mailgun-spy-api-CreateTestRespLinks:
      type: object
      properties:
        results:
          type: string
      required:
        - results
    Service_Documentation_github.com-mailgun-spy-api-SpyCreateTestResp:
      type: object
      properties:
        result_id:
          type: string
        links:
          $ref: >-
            #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-CreateTestRespLinks
      required:
        - result_id
        - links
    Service_Documentation_github.com-mailgun-spy-api-CreateTestReq:
      type: object
      properties:
        from:
          type: string
        subject:
          type: string
        html:
          type: string
        template_name:
          type: string
          description: template from Mailgun Send
        variables:
          type: object
          additionalProperties:
            type: string
        seed_list:
          type: string
          description: Use existing Seed List. If omitted creates new Seed List
        provider_filter:
          type: array
          items:
            type: string
          description: missing/null/[] means all providers
      required:
        - from
        - subject
    Service_Documentation_github.com-mailgun-spy-api-UnsupportedAuthentications:
      type: object
      properties:
        dkim:
          type: boolean
        spf:
          type: boolean
        dmarc:
          type: boolean
      required:
        - dkim
        - spf
        - dmarc
    Service_Documentation_github.com-mailgun-spy-api-Provider:
      type: object
      properties:
        domain:
          type: string
        display_name:
          type: string
        region:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        max_email_count:
          type: integer
          format: int32
        seeds_limit:
          type: integer
          format: int32
        unsupported_authentications:
          $ref: >-
            #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-UnsupportedAuthentications
        virtual:
          type: boolean
      required:
        - domain
        - display_name
        - region
        - created_at
        - updated_at
        - max_email_count
        - seeds_limit
        - unsupported_authentications
        - virtual
    Service_Documentation_github.com-mailgun-spy-api-ListProvidersResp:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/Service_Documentation_github.com-mailgun-spy-api-Provider
      required:
        - items
    Maverick_Score_github.com-mailgun-maverick-score-internal-entities-Rates:
      type: object
      properties:
        bounce_rate:
          type: integer
          format: int32
        complaint_rate:
          type: integer
          format: int32
        trap_rate:
          type: integer
          format: int32
        full_mailbox_rate:
          type: integer
          format: int32
        bad_failure_rate:
          type: integer
          format: int32
      required:
        - bounce_rate
        - complaint_rate
        - trap_rate
        - full_mailbox_rate
        - bad_failure_rate
    Maverick_Score_github.com-mailgun-maverick-score-internal-api-Counters:
      type: object
      properties:
        delivered:
          type: integer
          format: int64
      required:
        - delivered
    Maverick_Score_github.com-mailgun-maverick-score-internal-api-GetScoreResp:
      type: object
      properties:
        score:
          type: integer
          format: int32
        rates:
          $ref: >-
            #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-entities-Rates
        counters:
          $ref: >-
            #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-Counters
      required:
        - score
        - rates
        - counters
    Maverick_Score_github.com-mailgun-scaffold-httpapi-GenericAPIError:
      type: object
      properties:
        Reason:
          type: string
      required:
        - Reason
    Maverick_Score_github.com-mailgun-maverick-score-internal-api-ListScoreResp:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              group_key:
                type: string
              score:
                type: integer
                format: int32
              rates:
                $ref: >-
                  #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-entities-Rates
              counters:
                $ref: >-
                  #/components/schemas/Maverick_Score_github.com-mailgun-maverick-score-internal-api-Counters
            required:
              - group_key
              - score
              - rates
              - counters
        total:
          type: integer
          format: int64
      required:
        - items
        - total
    reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericAPIError:
      type: object
      properties:
        Reason:
          type: string
      required:
        - Reason
    reputationanalytics_github.com-mailgun-scaffold-httpapi-NotFoundError:
      type: object
      properties:
        Description:
          type: string
      required:
        - Description
    reputationanalytics_github.com-mailgun-scaffold-httpapi-GenericResponse:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DeliveryError:
      type: object
      properties:
        error_class:
          type: string
        error_type:
          type: string
        error_ratio:
          type: number
          format: float
      required:
        - error_class
        - error_type
        - error_ratio
    reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-IPCount:
      type: object
      properties:
        reputation:
          type: integer
          format: int32
        total:
          type: integer
          format: int64
      required:
        - reputation
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoop:
      type: object
      properties:
        id:
          type: string
        spam_ratio:
          type: number
          format: float
      required:
        - id
        - spam_ratio
    reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-Domain:
      type: object
      properties:
        account_id:
          type: string
        name:
          type: string
        user_reported_spam_ratio:
          type: number
          format: float
        spf_success_ratio:
          type: number
          format: float
        dkim_success_ratio:
          type: number
          format: float
        dmarc_success_ratio:
          type: number
          format: float
        inbound_encryption_ratio:
          type: number
          format: float
        delivery_error_ratio:
          type: number
          format: float
        delivery_errors:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DeliveryError
        reputation:
          type: integer
          format: int32
        date:
          type: string
          format: date-time
        ip_counts:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-IPCount
        feedback_loops:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoop
      required:
        - name
        - user_reported_spam_ratio
        - spf_success_ratio
        - dkim_success_ratio
        - dmarc_success_ratio
        - inbound_encryption_ratio
        - delivery_error_ratio
        - delivery_errors
        - reputation
        - date
        - ip_counts
        - feedback_loops
    reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainResponse:
      type: object
      properties:
        domain:
          type: string
        data:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-Domain
        total:
          type: integer
          format: int32
      required:
        - domain
        - data
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoopAggr:
      type: object
      properties:
        name:
          type: string
        id:
          type: string
        ratio:
          type: number
          format: float
        date:
          type: string
          format: date-time
      required:
        - name
        - id
        - ratio
        - date
    reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainFBLResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-FeedbackLoopAggr
        total:
          type: integer
          format: int32
      required:
        - data
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-models-address-IPAddress:
      type: object
      properties:
        address:
          type: string
        domain_name:
          type: string
        reputation:
          type: integer
          format: int32
        date:
          type: string
          format: date-time
      required:
        - address
        - domain_name
        - reputation
        - date
    reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressResponse:
      type: object
      properties:
        address:
          type: string
        data:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-address-IPAddress
        total:
          type: integer
          format: int32
      required:
        - address
        - data
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainAddressResponse:
      type: object
      properties:
        domain:
          type: string
        data:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-address-IPAddress
        total:
          type: integer
          format: int32
      required:
        - domain
        - data
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-api-Summary:
      type: object
      properties:
        name:
          type: string
        reputation:
          type: number
          format: float
        user_reported_spam_ratio:
          type: number
          format: float
        delivery_error_ratio:
          type: number
          format: float
      required:
        - name
        - reputation
        - user_reported_spam_ratio
        - delivery_error_ratio
    reputationanalytics_github.com-mailgun-reputationanalytics-api-SummaryResponse:
      type: object
      properties:
        summary:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-api-Summary
        total:
          type: integer
          format: int32
      required:
        - summary
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainSummary:
      type: object
      properties:
        name:
          type: string
        user_reported_spam_ratio:
          type: number
          format: float
        spf_success_ratio:
          type: number
          format: float
        dkim_success_ratio:
          type: number
          format: float
        dmarc_success_ratio:
          type: number
          format: float
        inbound_encryption_ratio:
          type: number
          format: float
        reputation:
          type: number
          format: float
      required:
        - name
        - user_reported_spam_ratio
        - spf_success_ratio
        - dkim_success_ratio
        - dmarc_success_ratio
        - inbound_encryption_ratio
        - reputation
    reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainSummaryResponse:
      type: object
      properties:
        summary:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainSummary
        total:
          type: integer
          format: int32
      required:
        - summary
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainErrorSummary:
      type: object
      properties:
        name:
          type: string
        delivery_error_ratio:
          type: number
          format: float
      required:
        - name
        - delivery_error_ratio
    reputationanalytics_github.com-mailgun-reputationanalytics-api-DomainErrorSummaryResponse:
      type: object
      properties:
        summary:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-domain-DomainErrorSummary
        total:
          type: integer
          format: int32
      required:
        - summary
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-models-address-AddressSummary:
      type: object
      properties:
        domain_name:
          type: string
        address:
          type: string
        reputation:
          type: number
          format: float
      required:
        - domain_name
        - address
        - reputation
    reputationanalytics_github.com-mailgun-reputationanalytics-api-AddressSummaryResponse:
      type: object
      properties:
        summary:
          type: array
          items:
            $ref: >-
              #/components/schemas/reputationanalytics_github.com-mailgun-reputationanalytics-models-address-AddressSummary
        ip_counts:
          type: object
          additionalProperties:
            type: integer
            format: int32
        total:
          type: integer
          format: int32
      required:
        - summary
        - ip_counts
        - total
    reputationanalytics_github.com-mailgun-reputationanalytics-api-TestResponse:
      type: object
      properties:
        items:
          type: array
          items:
            type: string
      required:
        - items
  securitySchemes:
    basicAuth:
      type: http
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
      scheme: basic
    Inbox_Ready_basicAuth:
      type: http
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
      scheme: basic
    Email_Preview_API_basicAuth:
      type: http
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
      scheme: basic
    Domain_Blocklist_Monitoring_basicAuth:
      type: http
      scheme: basic
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
    Spamtraps_Analytics_Service_basicAuth:
      type: http
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
      scheme: basic
    Service_Documentation_basicAuth:
      type: http
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
      scheme: basic
    Maverick_Score_basicAuth:
      type: http
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
      scheme: basic
    reputationanalytics_basicAuth:
      type: http
      description: >-
        HTTP Basic auth using api:YOUR_API_KEY. See
        [documentation](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)
      scheme: basic
x-tagGroups:
  - name: Mailgun Optimize API
    tags:
      - Domains
      - Inbox Placement
      - Email Preview
      - Spam Traps Monitoring
      - Email Health Score
      - IP Blocklist Monitoring
      - Domain Blocklist Monitoring
      - Google Postmaster Tools
      - Microsoft SNDS
      - Alerts
