# Icemail API

> Programmatic access to manage Icemail email infrastructure: domains, mailboxes, DNS records, workspaces, wallet and billing. Base URL: https://app.icemail.ai/api/v1. Auth: `x-api-key` header.

Static mirror of https://docs.icemail.ai, which renders client-side and is unreadable to most AI tools.

## Docs

- [Full documentation (single file)](llms-full.txt): every endpoint, parameter and schema
- [OpenAPI 3 spec](openapi.json): machine-readable source
- [Introduction](md/introduction.md): auth, pagination, errors

## Endpoints by section

- [Workspace](md/workspace.md): GET /workspace; POST /workspace; PUT /workspace; POST /workspace/invite
- [Wallet](md/wallet.md): GET /wallet; PUT /wallet/auto-topup; POST /wallet/topup
- [Domain](md/domain.md): GET /domain/available; GET /domain/{domainId}; GET /domain/ns-records; GET /domain/{domainId}/dns-records; POST /domain/{domainId}/dns-records; PUT /domain/{domainId}/dns-records; PUT /domain/{domainId}/forwarding; PUT /domain/{domainId}/dmarc; PUT /domain/forwarding; DELETE /domain/forwarding; PUT /domain/dmarc; DELETE /domain/dmarc; POST /domain/add-google-client-id; DELETE /domain/mailboxes; DELETE /domain/clear-dns; DELETE /domain; GET /domain
- [Mailbox](md/mailbox.md): GET /mailbox; GET /mailbox/price; GET /mailbox/{mailboxId}; PUT /mailbox/{mailboxId}; GET /mailbox/domain/{domainId}; PUT /mailbox/forwarding; DELETE /mailbox/forwarding; GET /mailbox/{mailboxId}/auth; GET /mailbox/{mailboxId}/app-password
- [Order](md/order.md): POST /order
- [Pre-Warm](md/pre-warm.md): GET /prewarm; POST /prewarm/buy
- [Export](md/export.md): POST /export; GET /export/{exportId}; POST /export/republish/{exportId}
- [Lookup](md/lookup.md): POST /lookup/mailboxes; POST /lookup/domains
- [Webhooks](md/webhooks.md): POST /webhook; GET /webhook; PUT /webhook/{webhookId}; DELETE /webhook/{webhookId}

## Optional

- [Schemas](md/schemas.md): shared data models