Legacy (v0)
Check and advance a domain's setup
Runs one bounded check of a custom domain’s DNS and certificate setup, records the result, and starts the next setup step when one is due. Call it after the customer changes DNS, or when a domain looks stuck. It checks once and does not wait for DNS propagation, so call it again later if the domain is not yet verified.
While the domain is unverified, meta.diagnostics compares the record the customer
must add (expected) with what public DNS currently serves (actual).
PATCH
/
api
/
domains
/
{id}
/
reconcile
Check and advance a domain's setup
curl --request PATCH \
--url https://api.fluid.app/api/domains/{id}/reconcile \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/domains/{id}/reconcile"
headers = {"Authorization": "Bearer <token>"}
response = requests.patch(url, headers=headers)
print(response.text)const options = {method: 'PATCH', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/domains/{id}/reconcile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/domains/{id}/reconcile",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/domains/{id}/reconcile"
req, _ := http.NewRequest("PATCH", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/domains/{id}/reconcile")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/domains/{id}/reconcile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"domain": {
"id": 5821,
"hostname": "shop.maplewellness.com",
"apex_domain": "maplewellness.com",
"verification_status": "pending_dns",
"connected": false,
"cert_created": true,
"dns_fluid_verified": "pending"
},
"meta": {
"check_result": {
"computed_status": "pending_dns",
"inconclusive": false
},
"diagnostics": {
"hostname": "shop.maplewellness.com",
"apex_domain": "maplewellness.com",
"is_apex": false,
"expected": {
"type": "CNAME",
"value": "host.fluid.app"
},
"actual": [
{
"type": "A",
"value": "203.0.113.10"
}
],
"dns_match": false,
"nameservers": [
"ns1.maplewellness-dns.com"
]
}
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
Bearer token authentication
Path Parameters
Domain ID
⌘I
Check and advance a domain's setup
curl --request PATCH \
--url https://api.fluid.app/api/domains/{id}/reconcile \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/domains/{id}/reconcile"
headers = {"Authorization": "Bearer <token>"}
response = requests.patch(url, headers=headers)
print(response.text)const options = {method: 'PATCH', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/domains/{id}/reconcile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/domains/{id}/reconcile",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/domains/{id}/reconcile"
req, _ := http.NewRequest("PATCH", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/domains/{id}/reconcile")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/domains/{id}/reconcile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"domain": {
"id": 5821,
"hostname": "shop.maplewellness.com",
"apex_domain": "maplewellness.com",
"verification_status": "pending_dns",
"connected": false,
"cert_created": true,
"dns_fluid_verified": "pending"
},
"meta": {
"check_result": {
"computed_status": "pending_dns",
"inconclusive": false
},
"diagnostics": {
"hostname": "shop.maplewellness.com",
"apex_domain": "maplewellness.com",
"is_apex": false,
"expected": {
"type": "CNAME",
"value": "host.fluid.app"
},
"actual": [
{
"type": "A",
"value": "203.0.113.10"
}
],
"dns_match": false,
"nameservers": [
"ns1.maplewellness-dns.com"
]
}
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}