# openmail-sh Policy API

**Canonical:** https://apis.io/apis/openmail-sh/openmail-sh-policy-api/  
**Provider:** openmail-sh — https://apis.io/providers/openmail-sh/  
**Base URL:** https://api.openmail.sh  
**Documentation:** https://docs.openmail.sh/api-reference/introduction

openmail-sh Policy API is one of 10 APIs that [openmail-sh](https://apis.io/providers/openmail-sh/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include policy. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Correspondent policy — provider-enforced allow/block rules and allowlist mode, scoped per account, pod, or inbox. Account-wide key only.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/policy` | Get correspondent policy |
| PUT | `/v1/policy` | Replace correspondent policy |
| GET | `/v1/policy/audit` | List correspondent policy audit events |
| PUT | `/v1/policy/mode` | Set correspondent policy mode |
| POST | `/v1/policy/rules` | Add correspondent policy rule |
| DELETE | `/v1/policy/rules/{id}` | Delete correspondent policy rule |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/openmail-sh/openapi/openmail-sh-policy-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-cold-cap-limits-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-inbox-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-domain-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-owned-domain-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-api-key-schema.json

## Other openmail-sh APIs (9)

- [openmail-sh Attachments API](https://apis.io/apis/openmail-sh/openmail-sh-attachments-api/)
- [openmail-sh Domains API](https://apis.io/apis/openmail-sh/openmail-sh-domains-api/)
- [openmail-sh Feedback API](https://apis.io/apis/openmail-sh/openmail-sh-feedback-api/)
- [openmail-sh Inboxes API](https://apis.io/apis/openmail-sh/openmail-sh-inboxes-api/)
- [openmail-sh Limits API](https://apis.io/apis/openmail-sh/openmail-sh-limits-api/)
- [openmail-sh Messages API](https://apis.io/apis/openmail-sh/openmail-sh-messages-api/)
- [openmail-sh Owned Domains API](https://apis.io/apis/openmail-sh/openmail-sh-owned-domains-api/)
- [openmail-sh Pods API](https://apis.io/apis/openmail-sh/openmail-sh-pods-api/)
- [openmail-sh Threads API](https://apis.io/apis/openmail-sh/openmail-sh-threads-api/)

## Tags

policy

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/openmail-sh/openmail-sh-policy-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/openmail-sh/.