PatchContactRequest

Body for updating a contact's editable fields. All fields are optional; provide at least one. On member contacts, the upstream-derived snapshot fields (first_name, last_name, org_name, email, phone, fax, address) are rejected; the refresher owns those columns. disclose and is_active are editable on both member and external contacts. On external contacts, all snapshot fields plus disclose and is_active are editable.

  • first_name
    Type: string
    min length:  
    1
    max length:  
    128

    Registrant first name. External contacts only.

  • region
    Type: string
    max length:  
    128

    Region, state, or province. External contacts only.

  • postal_code
    Type: string
    max length:  
    32

    Postal or ZIP code. External contacts only.

  • country_code
    Type: string

    ISO 3166-1 alpha-2 country code. External contacts only.

  • disclose
    Type: boolean

    Per-contact registry-disclosure flag. Editable on both kinds because disclosure is operator policy, not an upstream-derived value.

  • is_active
    Type: boolean

    Whether the contact is available for assignment to new team role slots. Editable on both kinds. Setting this to false on a contact that is currently referenced by any team's role slot is rejected with 422 contact.referenced_by_team; reassign or clear the slot first.

  • last_name
    Type: string
    min length:  
    1
    max length:  
    128

    Registrant last name. External contacts only.

  • org_name
    Type: string
    max length:  
    256

    Registrant organization name. External contacts only. Empty string clears.

  • email
    Type: string
    max length:  
    320

    Registrant email address. External contacts only. Empty string clears.

  • phone
    Type: string
    max length:  
    32

    Registrant phone in E.164 form. External contacts only. Provide an empty string to clear; normalized to canonical E.164 on save.

  • fax
    Type: string
    max length:  
    32

    Registrant fax in E.164 form. External contacts only. Empty string clears.

  • street1
    Type: string
    min length:  
    1
    max length:  
    256

    First line of the street address. External contacts only.

  • street2
    Type: string
    max length:  
    256

    Second line of the street address. External contacts only.

  • city
    Type: string
    min length:  
    1
    max length:  
    128

    City or locality. External contacts only.