NetBird Full API Reference + Read-Only MCP Prototype
POST/api/integrations/msp/tenants/{id}/dns

Verify an MSP tenant domain DNS challenge

Verifies the DNS challenge for an MSP tenant's domain. Use the id path parameter to select the tenant whose DNS challenge you want to verify. If verification fails, the response includes the dns_challenge value to add as a DNS TXT record.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter
idstringrequired
The unique identifier of the tenant account whose DNS challenge to verify.

6 status codes
200Returns confirmation that the DNS challenge was successfully verified.
400Returned when the request is invalid.
403Returned when the request is missing valid authentication.
404Returned when the tenant was not found.
500Returned when an internal server error occurs.
501Returned when DNS challenge verification fails. Includes the `dns_challenge` value to set in a TXT record.
dns_challengestringrequired
The DNS challenge to set in a TXT record

Error handling

A 400 indicates an invalid request, and a 403 indicates missing or invalid authentication. A 404 is returned when the tenant identified by the id path parameter is not found; a 500 indicates an internal server error. A 501 indicates DNS challenge verification failed; use the returned dns_challenge value in a DNS TXT record before retrying.