Trigger domain verification

curl --request POST \
  --url https://app.miget.com/api/v1/apps/{uuid}/domains/{domain_uuid}/verify \
  --header 'Authorization: <api-key>'

{
  "uuid": "<string>",
  "name": "<string>",
  "dns_target": "<string>",
  "verification_status": "<string>",
  "verification_token": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

App Domains

Trigger domain verification

Re-runs the DNS verification check for a custom domain. Caller is expected to have already configured the TXT record at _migetapp-verify.<domain> with the value from `verification_token`. The check runs asynchronously (Sidekiq worker `VerifyDomain` with Fibonacci backoff up to 60 minutes); poll the show endpoint to track status. If the domain is already verified, the call is a no-op and returns the current state. If the domain doesn't need verification (e.g. www subdomain whose root is verified), the call returns the current state without scheduling work.

POST

api

apps

{uuid}

domains

{domain_uuid}

verify

Trigger domain verification

curl --request POST \
  --url https://app.miget.com/api/v1/apps/{uuid}/domains/{domain_uuid}/verify \
  --header 'Authorization: <api-key>'

{
  "uuid": "<string>",
  "name": "<string>",
  "dns_target": "<string>",
  "verification_status": "<string>",
  "verification_token": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Bearer token for authentication. Format: 'Bearer {token}'

Headers

X-Workspace-Id

string

Workspace ID (uses default workspace if not provided)

Path Parameters

uuid

string

required

Application UUID

domain_uuid

string

required

Unique domain identifier (UUID)

Response

Trigger domain verification

Api_V1_Entities_Domain model

uuid

string

required

Unique domain identifier

name

string

required

Domain name

dns_target

string

required

DNS CNAME target — populated only after verification succeeds

verification_status

string

required

Verification state: 'pending', 'in_progress', 'verified', or 'failed'

verification_token

string

required

Token to publish as TXT _migetapp-verify.. Populated only while verification is needed; cleared once verified.

created_at

string<date-time>

required

Creation timestamp

updated_at

string<date-time>

required

Last update timestamp

Remove a custom domain List application add-ons