domains

Verify domain ownership

Changed on

Re-run DNS-based ownership verification against the records the user published. Returns the refreshed domain. Accepts the domain id or name.

post/v2/domains/{domain}/verify

Request

  • Base URL
    https://api.deno.com
  • Auth
    HTTP bearer

Path parameters

domainstring required

The domain ID or name (e.g. example.com). Domain IDs are UUIDs.

Response

OK

idstring required

Unique domain identifier (UUID)

organization_idstring required

Organization that owns the domain

domainstring required

The bare hostname (e.g. shop.acme.com). Wildcard coverage is reported via kind, never as a *. literal in this field.

kind'base_only' | 'wildcard_only' | 'base_and_wildcard' required

Whether the domain covers the apex, a wildcard, or both

verification_tokenstring required

Token to publish under _acme-challenge.<domain> for ownership verification

is_validatedboolean required

True once DNS-based ownership has been confirmed

created_atstring required

ISO 8601 timestamp of creation

updated_atstring required

ISO 8601 timestamp of last modification

Changes

    • breaking

      the // response's property type changed from no type to string for status

    • breaking

      the // response's property type changed from no type to string for status

    • breaking

      the response's property type changed from no type to string for status

    • breaking

      the / response's property type changed from no type to string for status