Create an email DNS request
Same contract as /api/request/ui, but creates an EMAIL request upstream.
curl -X POST "https://mail.haltman.io/api/request/email" \
-H "Content-Type: application/json" \
-d '{
"target": "example_string"
}'
import requests
import json
url = "https://mail.haltman.io/api/request/email"
headers = {
"Content-Type": "application/json"
}
data = {
"target": "example_string"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://mail.haltman.io/api/request/email", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"target": "example_string"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"target": "example_string"
}`)
req, err := http.NewRequest("POST", "https://mail.haltman.io/api/request/email", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://mail.haltman.io/api/request/email')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
"target": "example_string"
}'
response = http.request(request)
puts response.body
{}
{}
{
"error": "example_string",
"field": "example_string",
"reason": "example_string",
"hint": "example_string",
"constraints": {}
}
{
"error": "example_string"
}
{
"error": "example_string",
"ban": {},
"type": "example_string",
"value": "example_string"
}
{
"error": "Error",
"message": "Unsupported media type.",
"code": 415
}
{
"error": "example_string",
"where": "example_string",
"reason": "example_string"
}
{
"error": "Error",
"message": "Upstream dependency failure.",
"code": 502
}
{
"error": "Service Unavailable",
"message": "The service is temporarily unavailable. Please try again later",
"code": 503
}
POST
/api/request/email
POST
Content-Typestring
RequiredThe media type of the request body
Options: application/json
Request Preview
Response
Response will appear here after sending the request
Body
application/json
Responses
Upstream response payload.
Upstream accepted the request.
errorstring
Requiredfieldstring
reasonstring
hintstring
constraintsobject
errorstring
Requirederrorstring
Requiredbanobject
typestring
valuestring
errorstring
Requirederrorstring
Requiredwherestring
reasonstring
errorstring
Requirederrorstring
RequiredWas this page helpful?
Last updated Apr 9, 2026
Built with Documentation.AI