{
  "openapi": "3.1.0",
  "info": {
    "title": "Suppression Groups API",
    "version": "1.0.0",
    "description": "Manage suppression groups and suppression entries. Suppression groups let you categorize unsubscribes, bounces, and spam complaints so that you can control which emails are sent to which contacts."
  },
  "servers": [
    {
      "url": "https://api.autosend.com/v1",
      "description": "Production"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/suppression-groups": {
      "get": {
        "summary": "List Suppression Groups",
        "description": "Returns all suppression groups for the current project. Optionally filter to only global groups or include global groups alongside project-specific ones."
      },
      "post": {
        "summary": "Create Suppression Group",
        "description": "Creates a new suppression group."
      }
    },
    "/suppression-groups/{groupId}": {
      "get": {
        "summary": "Get Suppression Group",
        "description": "Returns a single suppression group by its ID."
      },
      "put": {
        "summary": "Update Suppression Group",
        "description": "Updates an existing suppression group."
      },
      "delete": {
        "summary": "Delete Suppression Group",
        "description": "Permanently deletes a suppression group by its ID."
      }
    },
    "/suppression-groups/email/entries": {
      "post": {
        "summary": "Get Email Suppression Groups",
        "description": "Returns all suppression groups that contain the given email address."
      }
    },
    "/suppression-groups/entries": {
      "post": {
        "summary": "Search Suppression Entries",
        "description": "Searches suppression entries with optional filters and pagination."
      }
    },
    "/suppression-groups/entries/all": {
      "post": {
        "summary": "Get All Suppression Entries",
        "description": "Returns all suppression entries without pagination. Useful for exporting or bulk processing."
      }
    },
    "/suppression-groups/emails/suppress": {
      "post": {
        "summary": "Bulk Suppress Emails",
        "description": "Adds one or more email addresses to a suppression group."
      }
    },
    "/suppression-groups/emails/unsuppress": {
      "post": {
        "summary": "Bulk Unsuppress Emails",
        "description": "Removes one or more email addresses from a suppression group."
      }
    }
  }
}