Whitelabel
Get Domain
Returns one custom app domain of your organization, in the same { domain, dns } shape as Add Domain. Requires the admin role.
GET /api/organization/whitelabel/domains/{id}
Access
Organization admins only, as for List Domains. Only domains with the role app are returned.
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET "$BASE_URL/api/organization/whitelabel/domains/3" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Response
200 OK
{
"domain": {
"id": 3,
"hostname": "monitoring.acme.example",
"status": "active",
"role": "app",
"isPrimary": true,
"verificationToken": "uptimeify-verify-def456",
"verifiedAt": "2026-06-02T08:00:00.000Z",
"createdAt": "2026-06-01T08:00:00.000Z",
"updatedAt": "2026-06-02T08:00:00.000Z"
},
"dns": {
"txtName": "_verify-status.monitoring.acme.example",
"txtValue": "uptimeify-verify-def456"
}
}Common errors
400 Bad Request(invalidDomainId) when the id is not a positive number401 Unauthorizedwhen you are not logged in403 Forbiddenwhen you are not an organization admin404 Not Found(domainNotFound) when the domain does not exist or belongs to another organization
List Domains
Returns all custom app domains for the organization. Only domains with role app are returned. Requires admin role.
Update Branding
Updates the organization's branding configuration. All fields are optional: only sent fields are updated. Setting productName or theme colors to null clears them. Requires admin role.