Verify domain ownership

POST

/api/v1/domains/{id}/verify

curl --request POST \
  --url https://api.deploybase.eu/api/v1/api/v1/domains/example/verify \
  --header 'Authorization: <Authorization>'

Verifies domain ownership by checking DNS TXT record

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string

Domain ID

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

domain

object

bunny_dns_ns1

string

bunny_dns_ns2

string

bunny_dns_zone_id

integer

connection_mode

string

Allowed values: byo_dns managed_dns

created_at

string

deleted_at

string

domain

string

geo_countries

Array<string>

geo_mode

GeoMode + GeoCountries hold the CDN geo-filtering policy (BACK-210). GeoCountries is the set the customer chose (allow set or block set per GeoMode), NOT the inverted Bunny list; the block-list sent to Bunny is derived on the fly by ComputeBlockedCountries. Effective only when the domain is on a dedicated pull zone (UsesDedicatedPullZone()).

string

Allowed values: off allowlist blocklist

id

string

last_verification_attempt

string

ns_delegated_at

string

project_id

string

pull_zone_id

PullZoneID is the dedicated Bunny pull zone for this custom domain in the 1:1 architecture (BACK-197/198), set at creation. NULL only when the CDN isn’t configured (dev/mock), in which case the domain has no CDN serving and falls back to the shared-PZ DNS instructions (see PointingTarget).

integer

ssl_attempts

NOTE: the explicit column tag is REQUIRED — GORM’s default namer mangles “SSLAttempts” to “s_slattempts” (it treats the embedded “SLA” as a known initialism), which doesn’t match the ssl_attempts column created in migration 000055. Without it every domains write fails with column "s_slattempts" does not exist. The other SSL* fields don’t collide, so only this one needs the override.

integer

ssl_error

string

ssl_error_code

Machine-readable failure reason (SSLErrorCode); drives reason-specific UI guidance

string

ssl_issued_at

string

ssl_last_attempt_at

string

ssl_provisioning_started_at

string

ssl_status

string

Allowed values: pending provisioning issued failed

status

string

Allowed values: pending_verification verified failed awaiting_delegation

team_id

string

updated_at

string

verification_token

string

verified_at

string

rate_limited

boolean

retry_after

Seconds until retry allowed

integer

Example

{
  "data": {
    "domain": {
      "connection_mode": "byo_dns",
      "geo_mode": "off",
      "ssl_status": "pending",
      "status": "pending_verification"
    }
  }
}

400

Bad Request

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

404

Not Found

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

429

Rate limited

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

500

DNS verification failed

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}