Update a check profile

PUT

/api/v1/data-source-groups/{uuid}

const url = 'https://app.hostrepute.com/api/v1/data-source-groups/01a178db-d581-700d-9729-4f4abc8cee72';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"name":"Default","description":"All production domains","is_default":true,"deliverability_checks_enabled":true,"deliverability_checks":["spf_record","dmarc_record","mx_health"]}'
};

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/data-source-groups/01a178db-d581-700d-9729-4f4abc8cee72 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "Default", "description": "All production domains", "is_default": true, "deliverability_checks_enabled": true, "deliverability_checks": [ "spf_record", "dmarc_record", "mx_health" ] }'

Change a check profile. Send only the fields you want to change. The slug can’t be changed.

Needs the data-source-group:update ability.

Authorizations

bearer

Parameters

Path Parameters

uuid

required

string

The UUID of the check profile.

Example

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

Request Body

application/json

object

name

The name of the check profile, up to 255 characters.

string

Example

Default

description

A short description, up to 255 characters.

string

nullable

Example

All production domains

is_default

Make this the team’s default profile. The previous default stops being the default.

boolean

Example

true

deliverability_checks_enabled

Run email authentication checks for the domains and IPs that use this profile.

boolean

Example

true

deliverability_checks

The email authentication checks to run, from reverse_dns, forward_confirmed_reverse_dns, generic_ptr, ptr_hostname_format, mx_health, spf_record, spf_strict, spf_lookup_limit, dmarc_record, dmarc_strict, mta_sts, tls_rpt and bimi. Read https://docs.hostrepute.com/reference/email-authentication-checks/ for what each one verifies.

Array<string>

Example

[
  "spf_record",
  "dmarc_record",
  "mx_health"
]

Responses

200

application/json

object

data

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

Example

{
  "data": {
    "uuid": "01a178db-d581-700d-9729-4f4abc8cee72",
    "name": "Default",
    "slug": "default",
    "description": "All production domains",
    "is_default": true,
    "deliverability_checks_enabled": true,
    "deliverability_checks": [
      "spf_record",
      "dmarc_record",
      "mx_health"
    ],
    "created_at": "2026-07-14T09:12:44.000000Z",
    "updated_at": "2026-10-26T15:37:15.000000Z"
  }
}

404

No check profile with this UUID in your team

application/json

object

message

string

Example

{
  "message": "No query results for model [App\\Models\\DataSourceGroup] 01a178db-d581-700d-9729-4f4abc8cee72"
}

422

Plan limit reached

application/json

object

message

string

errors

object

deliverability_checks_enabled

Array<string>

Example

{
  "message": "Your current plan includes 5 deliverability profile(s).",
  "errors": {
    "deliverability_checks_enabled": [
      "Your current plan includes 5 deliverability profile(s)."
    ]
  }
}