Hostnames · host.update
PUT/host/{host}host.update
Update a hostname
Update the configuration of a connected hostname.
- Base URL
- https://api.redirhub.com/v1
- Auth
- Bearer token
- Idempotent
- Yes
- Returns
- application/json
The request
Send a JSON body to PUT /host/{host}. Every field is optional — send only what you want to set. The host path segment identifies the record.
# Update a hostname
curl -X PUT "https://api.redirhub.com/v1/host/go.acme.com" \
-H "Authorization: Bearer $REDIRHUB_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"https_requested": true,
"short_links_enabled": true
}'Path parameters
| Parameter | Description |
|---|---|
| hostRequiredstring |
Body parameters
| Field | Description |
|---|---|
| https_requestedoptionalboolean | Whether the platform should issue and renew an SSL certificate for this hostname and accept HTTPS traffic on it. |
| short_links_enabledoptionalboolean | Whether this hostname may be used to create new short links. QR codes are generated from short links, so this also controls QR code creation on this hostname. Existing links and QR codes continue to resolve when disabled. |
The response
A 200 returns the record as JSON.
{
"host": "go.acme.com",
"domain": "string",
"correct": true,
"default_require": "ip",
"require": [
"string"
],
"current": [
{
"type": "link",
"value": "string",
"line": "string"
}
],
"errors": [
{
"scope": "string",
"message": "The given data was invalid.",
"updated_at": "2026-08-01T09:14:22Z"
}
],
"counts": [
"string"
],
"https_requested": true,
"short_links_enabled": true,
"public": true,
"notice": "string",
"checked_at": "string",
"created_at": "2026-08-01T09:14:22Z",
"updated_at": "2026-08-01T09:14:22Z"
}Status codes
200
SuccessThe updated hostname.
401
UnauthenticatedUnauthenticated
422
Validation failedA field was rejected.
errors lists every field with its reason.429
Too many requestsToo many requests
484
Bad requestThe workspace role of the authenticated user is too low for this action.
What usually comes next
One call is rarely the whole job. These are the endpoints most integrations reach for around this one.