Skip to main content
POST
/
domains
/
{domain}
/
dkim-keys
/
{selector}
/
rotate
Rotate DKIM Key Pair
curl --request POST \
  --url https://api.mailchannels.net/tx/v1/domains/{domain}/dkim-keys/{selector}/rotate \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "new_key": {
    "selector": "<string>"
  }
}
'
{
  "new_key": {
    "algorithm": "<string>",
    "domain": "<string>",
    "public_key": "<string>",
    "selector": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "dkim_dns_records": [
      {
        "name": "<string>",
        "type": "TXT",
        "value": "<string>"
      }
    ],
    "gracePeriodExpiresAt": "2023-11-07T05:31:56Z",
    "key_length": 123,
    "retiresAt": "2023-11-07T05:31:56Z",
    "status_modified_at": "2023-11-07T05:31:56Z"
  },
  "rotated_key": {
    "algorithm": "<string>",
    "domain": "<string>",
    "public_key": "<string>",
    "selector": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "dkim_dns_records": [
      {
        "name": "<string>",
        "type": "TXT",
        "value": "<string>"
      }
    ],
    "gracePeriodExpiresAt": "2023-11-07T05:31:56Z",
    "key_length": 123,
    "retiresAt": "2023-11-07T05:31:56Z",
    "status_modified_at": "2023-11-07T05:31:56Z"
  }
}

Headers

X-Api-Key
string
required

Path Parameters

domain
string
required
selector
string
required
Required string length: 1 - 63

Body

application/json
new_key
object
required

Response

Key pair status updated and new key pair created successfully

new_key
object
required
rotated_key
object
required