Domain Contacts2026.8.0

Update domain contact

Modifies details of an existing domain contact.

PATCH/api/v1/spaces/assets/domains/{domain}/contacts/{contactId}

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

domainstringRequired: Domain name in FQDN format
contactIdintegerRequired: Identifier of the contact

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

contactobjectRequired

No field description supplied.

typestringRequired

Allowed values: "PERSON", "ORG".

rolestringRequired

Allowed values: "owner", "admin", "tech", "billing".

firstNamestringRequired

No field description supplied.

lastNamestringRequired

No field description supplied.

genderstringRequired

Allowed values: "M", "F", "U".

emailstring (email)Required

No field description supplied.

phoneobjectRequired

No field description supplied.

addressobjectRequired

No field description supplied.

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request PATCH 'https://dashio.net/api/v1/spaces/assets/domains/{domain}/contacts/{contactId}' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "contact": {
    "type": "PERSON",
    "role": "owner",
    "firstName": "<firstName>",
    "lastName": "<lastName>",
    "gender": "M",
    "email": "<email>",
    "phone": {
      "countryCode": "<countryCode>",
      "areaCode": "<areaCode>",
      "subscriberNumber": "<subscriberNumber>"
    },
    "address": {
      "street": [
        "<street>"
      ],
      "city": "<city>",
      "zip": "<zip>",
      "country": "<country>"
    }
  }
}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Schema-generated example; not a captured response.

{
  "contact": {
    "id": 0,
    "type": "PERSON",
    "role": "owner",
    "firstName": "<firstName>",
    "lastName": "<lastName>",
    "gender": "M",
    "email": "<email>",
    "phone": {
      "countryCode": "<countryCode>",
      "areaCode": "<areaCode>",
      "subscriberNumber": "<subscriberNumber>"
    },
    "address": {
      "street": [
        "<street>"
      ],
      "city": "<city>",
      "zip": "<zip>",
      "country": "<country>"
    }
  }
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

Contact updated successfully.

contactobjectRequired

No field description supplied.

idnumberRequired

No field description supplied.

typestringRequired

Allowed values: "PERSON", "ORG".

rolestringRequired

Allowed values: "owner", "admin", "tech", "billing".

firstNamestringRequired

No field description supplied.

lastNamestringRequired

No field description supplied.

genderstringRequired

Allowed values: "M", "F", "U".

emailstring (email)Required

No field description supplied.

phoneobjectRequired

No field description supplied.

addressobjectRequired

No field description supplied.

400

Invalid request.

No response body schema supplied.

404

Domain or contact not found.

No response body schema supplied.

500

Failed to update contact.

No response body schema supplied.

Was this helpful?

Update domain contact

Authentication

Path parameters

Query parameters

Header parameters

Cookie parameters

Request body

8 child fields

Responses

200

9 child fields

400

404

500