Samva
DashboardAPI
ChannelsPlatformMailboxesDevelopersEmail templatesIntegrationsAPI Reference
Email

Recheck a custom tracking domain's certificate

Checks the hostname's certificate now instead of waiting for the next scheduled check, and returns the refreshed state.

POST
/v1/email/domains/{id}/custom-tracking/recheck

Checks the hostname's certificate now instead of waiting for the next scheduled check, and returns the refreshed state. Samva checks a hostname at most once every 30 seconds; a recheck inside that window returns the state from the last check. Returns a conflict when custom tracking is disabled or being torn down.

Authorization

apiKey
x-api-key<token>

In: header

Path Parameters

id*string
Match^dom_[0-9a-hjkmnp-tv-z]{16,24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/email/domains/string/custom-tracking/recheck"
{  "enabled": true,  "customTracking": {    "status": "pending",    "label": "string",    "hostname": "string",    "region": "string",    "sslStatus": "string",    "certificate": {      "reason": {        "code": "initializing",        "message": "string"      },      "lastCheckedAt": "string",      "nextCheckAt": "string"    },    "dnsRecords": {      "tracking": {        "name": "string",        "type": "string",        "value": "string"      },      "dcvDelegation": {        "name": "string",        "type": "string",        "value": "string"      }    },    "caaBlocked": true,    "verificationErrors": [      "string"    ],    "teardownScheduledAt": "string"  }}

Related documentation

Reapply for email onboarding review

Allows an organization owner or admin to submit a rejected organization for review again. The expected generation prevents acting on stale status.

Remove a block entry

Permanently deletes a block entry, unblocking the associated address or domain. Use this endpoint to remove a block entry through the Samva email API.