Update a domain or IP

PUT

/api/v1/hosts/{uuid}

const url = 'https://app.hostrepute.com/api/v1/hosts/01a178db-d582-717c-8bb6-f01625c3d70f';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"data_source_group_uuid":"01a178db-d581-700d-9729-4f4abc8cee72","name":"Primary mail server","host":"mail.example.com"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://app.hostrepute.com/api/v1/hosts/01a178db-d582-717c-8bb6-f01625c3d70f \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "data_source_group_uuid": "01a178db-d581-700d-9729-4f4abc8cee72", "name": "Primary mail server", "host": "mail.example.com" }'

Change the name, address or check profile of a domain or IP. Send only the fields you want to change.

Needs the host:update ability.

Authorizations

bearer

Parameters

Path Parameters

uuid

required

string

The UUID of the domain or IP.

Example

01a178db-d582-717c-8bb6-f01625c3d70f

Request Body

application/json

object

data_source_group_uuid

The UUID of the check profile to use.

string

Example

01a178db-d581-700d-9729-4f4abc8cee72

name

A name for the domain or IP, up to 255 characters.

string

Example

Primary mail server

host

The domain or IP address to monitor. A new address must be public.

string

Example

mail.example.com

Responses

200

application/json

object

data

object

uuid

string

name

string

host

string

blocklisted_at

string

nullable

data_source_group

object

uuid

string

name

string

slug

string

description

string

is_default

boolean

deliverability_checks_enabled

boolean

deliverability_checks

Array<string>

created_at

string

updated_at

string

created_at

string

updated_at

string

Example

{
  "data": {
    "uuid": "01a178db-d582-717c-8bb6-f01625c3d70f",
    "name": "Primary mail server",
    "host": "mail.example.com",
    "blocklisted_at": null,
    "data_source_group": {
      "uuid": "01a178db-d581-700d-9729-4f4abc8cee72",
      "name": "Default",
      "slug": "default",
      "description": "All production domains",
      "is_default": true,
      "deliverability_checks_enabled": true,
      "deliverability_checks": [
        "mx_health",
        "spf_record",
        "spf_strict",
        "spf_lookup_limit",
        "dmarc_record",
        "dmarc_strict"
      ],
      "created_at": "2026-07-14T09:12:44.000000Z",
      "updated_at": "2026-09-02T14:05:31.000000Z"
    },
    "created_at": "2026-07-14T09:15:02.000000Z",
    "updated_at": "2026-10-26T15:37:15.000000Z"
  }
}

404

No domain or IP with this UUID in your team

application/json

object

message

string

Example

{
  "message": "No query results for model [App\\Models\\Host] 01a178db-d582-717c-8bb6-f01625c3d70f"
}

422

Invalid input

application/json

object

message

string

errors

object

data_source_group_uuid

Array<string>

Example

{
  "message": "The selected data source group uuid is invalid.",
  "errors": {
    "data_source_group_uuid": [
      "The selected data source group uuid is invalid."
    ]
  }
}