Skip to content
deploybase

Admin custom domains overview

GET
/api/v1/admin/domains
 
curl --request GET \
  --url https://api.deploybase.eu/api/v1/api/v1/admin/domains \
  --header 'Authorization: <Authorization>'

The custom-domain funnel (added, verified, live, abandoned, median step times) over all time and the last 30 days, split by apex/subdomain and by connection mode; domains stuck before verification; verified domains still without a certificate after an hour (with the operator-only CDN error); and domains that went live in the last 7 days. Cross-team, platform admins only.

Authorizations

Section titled “ Authorizations ”

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

OK

Media type application/json
object
data
meta
object
request_id
string
timestamp
string
trace_id
string
data
object
funnel
object
all_time
object
by_connection_mode
object
key
additional properties
object
abandoned
integer
added
integer
live
integer
median_minutes_to_live
number
median_minutes_to_verified
number
verified
integer
by_kind
object
key
additional properties
object
abandoned
integer
added
integer
live
integer
median_minutes_to_live
number
median_minutes_to_verified
number
verified
integer
total
object
abandoned
integer
added
integer
live
integer
median_minutes_to_live
number
median_minutes_to_verified
number
verified
integer
window_days

WindowDays is null for all time.

integer
last_30d
object
by_connection_mode
object
key
additional properties
object
abandoned
integer
added
integer
live
integer
median_minutes_to_live
number
median_minutes_to_verified
number
verified
integer
by_kind
object
key
additional properties
object
abandoned
integer
added
integer
live
integer
median_minutes_to_live
number
median_minutes_to_verified
number
verified
integer
total
object
abandoned
integer
added
integer
live
integer
median_minutes_to_live
number
median_minutes_to_verified
number
verified
integer
window_days

WindowDays is null for all time.

integer
generated_at
string
live_recent
Array<object>
object
domain
string
domain_id
string
kind
string
owner_email
string
project_id
string
project_name
string
ssl_issued_at
string
team_id
string
stuck_certificate
Array<object>
object
connection_mode
string
created_at
string
days_stuck

DaysStuck is fractional days since verification.

number
domain
string
domain_id
string
kind
string
owner_email
string
project_id
string
project_name
string
ssl_attempts
integer
ssl_error
string
ssl_error_code
string
ssl_error_detail
string
ssl_last_attempt_at
string
ssl_status
string
team_id
string
verified_at
string
stuck_verification
Array<object>
object
connection_mode
string
created_at
string
days_stuck

DaysStuck is fractional days since the domain was added.

number
domain
string
domain_id
string
kind
string
last_verification_attempt
string
owner_email
string
project_id
string
project_name
string
status
string
team_id
string

Example generated

{
  "data": {
    "funnel": {
      "all_time": {
        "by_connection_mode": {
          "additionalProperty": {
            "abandoned": 1,
            "added": 1,
            "live": 1,
            "median_minutes_to_live": 1,
            "median_minutes_to_verified": 1,
            "verified": 1
          }
        },
        "by_kind": {
          "additionalProperty": {
            "abandoned": 1,
            "added": 1,
            "live": 1,
            "median_minutes_to_live": 1,
            "median_minutes_to_verified": 1,
            "verified": 1
          }
        },
        "total": {
          "abandoned": 1,
          "added": 1,
          "live": 1,
          "median_minutes_to_live": 1,
          "median_minutes_to_verified": 1,
          "verified": 1
        },
        "window_days": 1
      },
      "last_30d": {
        "by_connection_mode": {
          "additionalProperty": {
            "abandoned": 1,
            "added": 1,
            "live": 1,
            "median_minutes_to_live": 1,
            "median_minutes_to_verified": 1,
            "verified": 1
          }
        },
        "by_kind": {
          "additionalProperty": {
            "abandoned": 1,
            "added": 1,
            "live": 1,
            "median_minutes_to_live": 1,
            "median_minutes_to_verified": 1,
            "verified": 1
          }
        },
        "total": {
          "abandoned": 1,
          "added": 1,
          "live": 1,
          "median_minutes_to_live": 1,
          "median_minutes_to_verified": 1,
          "verified": 1
        },
        "window_days": 1
      }
    },
    "generated_at": "example",
    "live_recent": [
      {
        "domain": "example",
        "domain_id": "example",
        "kind": "example",
        "owner_email": "example",
        "project_id": "example",
        "project_name": "example",
        "ssl_issued_at": "example",
        "team_id": "example"
      }
    ],
    "stuck_certificate": [
      {
        "connection_mode": "example",
        "created_at": "example",
        "days_stuck": 1,
        "domain": "example",
        "domain_id": "example",
        "kind": "example",
        "owner_email": "example",
        "project_id": "example",
        "project_name": "example",
        "ssl_attempts": 1,
        "ssl_error": "example",
        "ssl_error_code": "example",
        "ssl_error_detail": "example",
        "ssl_last_attempt_at": "example",
        "ssl_status": "example",
        "team_id": "example",
        "verified_at": "example"
      }
    ],
    "stuck_verification": [
      {
        "connection_mode": "example",
        "created_at": "example",
        "days_stuck": 1,
        "domain": "example",
        "domain_id": "example",
        "kind": "example",
        "last_verification_attempt": "example",
        "owner_email": "example",
        "project_id": "example",
        "project_name": "example",
        "status": "example",
        "team_id": "example"
      }
    ]
  },
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Section titled “ 401 ”

Unauthorized

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"
  }
}

403

Section titled “ 403 ”

Forbidden

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

Section titled “ 500 ”

Internal Server Error

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"
  }
}

503

Section titled “ 503 ”

Service Unavailable

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"
  }
}

Live 174db30c built