Skip to main content
POST
/
email
/
sending-identities
/
{identityId}
/
status
Refresh identity status
curl --request POST \
  --url https://www.dench.com/api/v1/email/sending-identities/{identityId}/status \
  --header 'Authorization: Bearer <token>'
{
  "identityId": "esi_abc123",
  "identity": "example.com",
  "deliveryVerificationStatus": "pending",
  "deliveryVerified": false,
  "domain": "example.com",
  "domainVerified": false,
  "emailVerified": true,
  "denchVerificationStatus": "verified",
  "disabled": false,
  "dnsRecords": [
    {
      "type": "CNAME",
      "name": "abc123token._domainkey.example.com",
      "value": "abc123token.dkim.amazonses.com",
      "purpose": "DKIM (required for domain verification)"
    }
  ],
  "message": "Domain example.com is pending DNS verification."
}

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Path Parameters

identityId
string
required

Sending identity id.

Response

Successful response

identityId
string
required
identity
string
required
deliveryVerificationStatus
enum<string>
required

Provider-side (DNS/mailbox) verification status.

Available options:
pending,
verified,
failed,
disabled
deliveryVerified
boolean
required
domainVerified
boolean
required
emailVerified
boolean
required
denchVerificationStatus
enum<string>
required

Workspace-side sender verification status.

Available options:
pending,
verified,
expired,
disabled
disabled
boolean
required
domain
string
dnsRecords
object[]
domainVerificationInfo
object

Provider DNS poll info for pending domains.

message
string
{key}
any