# Organization API: Customer Portal: Suppressions

> The 3 Organization API operations for suppressions.

Source: https://www.coritan.com/docs/api/reference/organizations/customer-portal/mail-suppressions/

Part of [Customer Portal](/docs/api/reference/organizations/customer-portal/).

## Operations

| Method | Path | Summary |
| --- | --- | --- |
| GET | [`/api/v1/orgs/{org_slug}/portal/mail/{service_id}/suppressions`](#op-get-api-v1-orgs-org-slug-portal-mail-service-id-suppressions) | List suppressions |
| POST | [`/api/v1/orgs/{org_slug}/portal/mail/{service_id}/suppressions`](#op-post-api-v1-orgs-org-slug-portal-mail-service-id-suppressions) | Add suppression |
| DELETE | [`/api/v1/orgs/{org_slug}/portal/mail/{service_id}/suppressions/{suppression_id}`](#op-delete-api-v1-orgs-org-slug-portal-mail-service-id-suppressions-suppression-id) | Remove suppression |

### List suppressions {#op-get-api-v1-orgs-org-slug-portal-mail-service-id-suppressions}

`GET /api/v1/orgs/{org_slug}/portal/mail/{service_id}/suppressions`

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `org_slug` | path | string | yes |
| `service_id` | path | integer | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |

### Add suppression {#op-post-api-v1-orgs-org-slug-portal-mail-service-id-suppressions}

`POST /api/v1/orgs/{org_slug}/portal/mail/{service_id}/suppressions`

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `org_slug` | path | string | yes |
| `service_id` | path | integer | yes |

#### Request body

`application/json` (required)

| Field | Type | Required |
| --- | --- | --- |
| `address` | string | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `201` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |

### Remove suppression {#op-delete-api-v1-orgs-org-slug-portal-mail-service-id-suppressions-suppression-id}

`DELETE /api/v1/orgs/{org_slug}/portal/mail/{service_id}/suppressions/{suppression_id}`

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `suppression_id` | path | integer | yes |
| `org_slug` | path | string | yes |
| `service_id` | path | integer | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |