Storage & Quotas

Mailbox Storage Quota

Control how much disk space each mailbox can use.

Get Quota

GET /users/{email}/quota

curl https://api.emboux.com/users/[email protected]/quota \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "email": "[email protected]",
  "quota_mb": 2048
}

Set Quota

PUT /users/{email}/quota

Field	Type	Required	Description
`quota_mb`	integer	Yes	Storage limit in megabytes

curl -X PUT https://api.emboux.com/users/[email protected]/quota \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quota_mb": 4096}'

{
  "email": "[email protected]",
  "quota_mb": 4096
}

When a mailbox reaches its storage limit, EmBoux rejects new incoming messages with a temporary error, prompting the sender to retry later.

Email Retention

Set how many days emails are kept before automatic deletion. A server-side cron job purges expired messages daily.

Get Retention

GET /domains/{domain_name}/retention

curl https://api.emboux.com/domains/mycompany.com/retention \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "name": "mycompany.com",
  "retention_days": 60
}

Set Retention

PUT /domains/{domain_name}/retention

Field	Type	Required	Description
`retention_days`	integer	Yes	Days to keep emails. Older messages are deleted.

curl -X PUT https://api.emboux.com/domains/mycompany.com/retention \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retention_days": 90}'

Monthly Transfer Limit

Set a monthly bandwidth cap per domain.

Get Transfer Limit

GET /domains/{domain_name}/transfer

curl https://api.emboux.com/domains/mycompany.com/transfer \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "name": "mycompany.com",
  "transfer_monthly_mb": 10240
}

Set Transfer Limit

PUT /domains/{domain_name}/transfer

Field	Type	Required	Description
`transfer_monthly_mb`	integer	Yes	Monthly transfer cap in megabytes

curl -X PUT https://api.emboux.com/domains/mycompany.com/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transfer_monthly_mb": 20480}'

Plan Defaults

When using the Odoo integration, these values are automatically set from the customer’s plan:

Plan	Storage/Mailbox	Retention	Monthly Transfer
Starter	1 GB	30 days	5 GB
Business	2 GB	60 days	10 GB
Enterprise	5 GB	90 days	50 GB

Limits are pushed to the API automatically when a subscription is confirmed or changed.