Hostnames
Add hostname
Add a custom hostname to a client tenant. The hostname is verified asynchronously via DNS lookup. Returns 409 Conflict if the hostname is already associated with another client.
curl -X POST "https://api.mythic-analytics.com/api/v1/clients/example_string/hostnames" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"hostname": "analytics.acme-retail.com"
}'
import requests
import json
url = "https://api.mythic-analytics.com/api/v1/clients/example_string/hostnames"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"hostname": "analytics.acme-retail.com"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api.mythic-analytics.com/api/v1/clients/example_string/hostnames", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"hostname": "analytics.acme-retail.com"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"hostname": "analytics.acme-retail.com"
}`)
req, err := http.NewRequest("POST", "https://api.mythic-analytics.com/api/v1/clients/example_string/hostnames", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
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://api.mythic-analytics.com/api/v1/clients/example_string/hostnames')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"hostname": "analytics.acme-retail.com"
}'
response = http.request(request)
puts response.body
{
"success": true,
"data": {
"hostname": "analytics.acme-retail.com",
"verified": true,
"created_at": "2024-06-15T10:30:00.000Z"
}
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Conflict",
"message": "The request conflicts with the current state of the resource",
"code": 409,
"details": "Resource already exists"
}
POST
/clients/{id}/hostnamesPOST
Security Scheme
Bearer Tokenstring
RequiredAdmin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY
Admin API key as bearer token. Format:
Bearer YOUR_ADMIN_KEYpath
idstring
RequiredClient identifier.
Pattern: ^[a-zA-Z0-9_-]{1,255}$
Content-Typestring
RequiredThe media type of the request body
Options: application/json
hostnamestring
RequiredFully-qualified domain name to associate with the client.
Request Preview
Response
Response will appear here after sending the request
Authentication
header
Authorizationstring
RequiredBearer token. Admin API key as bearer token. Format: Bearer YOUR_ADMIN_KEY
Path Parameters
idstring
RequiredClient identifier.
Body
application/json
hostnamestring
RequiredFully-qualified domain name to associate with the client.
Responses
Was this page helpful?
Built with Documentation.AI
Last updated today