`PUT /domains/{id}` — update a domain.
/domains/{id}Path Parameters
Domain id
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X PUT "https://example.com/domains/string" \ -H "Content-Type: application/json" \ -d '{}'{ "auto_join_disabled_at": "string", "consecutive_failure_count": 0, "created_at": "string", "degraded_at": "string", "domain": "string", "id": "string", "last_checked_at": "string", "last_verified_at": "string", "org_id": "string", "revoked_at": "string", "settings": null, "status": null, "updated_at": "string", "verification_token": "string", "verified_at": "string"}`GET /domains` — list all domains in the org. GET
Previous Page
`POST /domains/{id}/verifications` — perform domain verification. POST
Looks up the TXT record at `_vigilfield-verification.<domain>` and matches it against the per-domain `verification_token` from the row. The lookup is synchronous: success transitions the row to `verified` with `verified_at = now()`; failure leaves the row's existing verification state intact and returns 4xx. Three outcomes from the resolver map onto three response shapes: - `Matched` → 200, row updated. - `NotFound` → 403 with `domain verification failed` (anti- enumeration: same body whether the record is absent or carries a wrong token). - `ResolverError` → 503 so the caller knows to retry rather than surfacing "verification failed" to the user when DNS itself is the problem.