API reference

Recheck domain verification

Enqueues an immediate DNS verification check for a specific provider verification. Useful after publishing DNS records without waiting for the background poller. Required role: admin or owner.

POST/v1/admin/sending-domains/:id/verifications/:verificationId/recheck

Authenticate with a session token and X-Tenant-Slug. Required role: admin or owner.

Enqueues a verify job with zero delay, bypassing the 30-second background polling interval. Obtain the verificationId from GET .../verifications.

Request

curl

curl -X POST https://api-raven-cloud.autotribes.app/v1/admin/sending-domains/$DOMAIN_ID/verifications/$VERIFICATION_ID/recheck \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-Slug: my-tenant"

No request body required.

Response

202 Accepted

Empty body. The verification job has been enqueued. Poll GET .../verifications after a few seconds to read the updated verificationState, lastCheckedAt, and lastCheckError.

Timing

TYPICALLY COMPLETES IN ~10 SECONDS

The verify job runs immediately once picked up by a queue worker. In practice, verificationState updates within ~10 seconds of calling this endpoint. DNS propagation delays are outside Nudgel's control — if the check still fails, wait a minute for TTL expiry and call recheck again.

Calling recheck on an already-verified verification is safe; Nudgel re-confirms the records and updates lastCheckedAt without changing status.

Errors

Status	When
`401`	Invalid or expired session token
`403`	Caller does not have admin or owner role
`404`	Sending domain or verification not found for this tenant