Data Retention & PII Modes

Pilot Status lets you control how long sensitive data (PII) is stored. There are two independent layers:

1. API-key-level retention — how long outbound message logs keep PII.
2. Per-number PII mode — whether inbound/outbound chat messages and conversations are stored at all.

​

API-key-level retention

Configured per API key on the API Keys page (/api-keys):

• retentionDays > 0 — PII in outbound message logs is kept for up to N days.
• retentionDays = 0 — PII is not persisted.

Even with retention off, webhook events are still delivered — sensitive fields (e.g. destinationNumber, content) may be empty, but IDs, timestamps, status, and tracking metadata remain.

​

Per-number PII mode

Each WhatsApp number is configured independently with one of three modes (set on the number’s settings in the dashboard):

​

Effect on the dashboard

​

Effect on v1 read endpoints

GET /v1/conversations, GET /v1/messages/unread, and GET /v1/messages/group apply the same gate:

​

Forwarding is always active

Regardless of PII mode, these always work:

• Outbound webhooks (delivery events and inbound events)
• The Chatwoot integration (receiving and replying)
• Sending messages

Only storage and read-back are affected.

​

Related

• Webhooks
• Chatwoot integration