Rotate DKIM Key Pair
POST/domains/:domain/dkim-keys/:selector/rotate
Rotate an active DKIM key pair. Mark the original key as 'rotated', and create a new key pair with the required new key selector, reusing the same algorithm and key length. The rotated key remains valid for signing for a 3-day grace period, and is automatically changed to 'retired' 2 weeks after rotation. Publish the new key to its DNS TXT record before rotated key expires for signing as emails sent with an unpublished key will fail DKIM validation by receiving providers. After the grace period, only the new key is valid for signing if published.
Request
Responses
- 201
- 400
- 404
- 409
- 500
- 503
Key pair status updated and new key pair created successfully
Bad Request
Specified key pair not found
Key pair already created for domain, and provided new key selector.
Internal Server Error
Temporarily unavailable for maintenance
Response Headers
Suggested wait time in seconds before retrying.