---
title: "Update Address object"
slug: "update-address-object"
updated: 2026-02-18T12:52:38Z
published: 2026-02-18T12:52:58Z
canonical: "support.perimeter81.com/update-address-object"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.perimeter81.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Address object

Put/v2.3/objects/addresses/{objectId}

Required permission: `["objects:update"]`

SecurityHTTPType bearer

Path parametersobjectIdstringRequired

Body parameters<select class='api-response-data' aria-label='Media type'><option value='69826426-e68b-4187-a55a-65bee5e34c36'>application/json</option>
</select>object  idstring    

Unique Address ID

namestring    Required

The name of the Objects

Min length3Max length100Pattern^[a-zA-Z0-9_ ]+$
descriptionstring    
OneOfObjectsAddressIPobject (ObjectsAddressIP)valueTypestring    RequiredValid values[
  "ip"
]
value Array of string (IP)   RequiredMin items1Max items1string  (ipv4)    

ObjectsAddressIPListobject (ObjectsAddressIPList)valueTypestring    RequiredValid values[
  "list"
]
value Array of string (IP)   Required

Must be a unique list of IPs

Min items1string  (ipv4)    

ObjectsAddressCIDRobject (ObjectsAddressCIDR)valueTypestring    RequiredValid values[
  "cidr"
]
value Array of string (CIDR)   RequiredMin items1Max items1string    Pattern^((?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3})(\/(3[0-2]|[1-2][0-9]|[0-9]))$

ObjectsAddressFQDNobject (ObjectsAddressFQDN)valueTypestring    RequiredValid values[
  "fqdn"
]
value Array of string (FQDN)   RequiredMin items1Max items1string    Pattern(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)

Responses200

Success

<select class='api-response-data' aria-label='Media type'><option value='eba8a875-024c-413f-bab6-6f52290ab312'>application/json</option>
</select>object  idstring    

Unique Address ID

namestring    

The name of the Objects

Min length3Max length100Pattern^[a-zA-Z0-9_ ]+$
descriptionstring    
OneOfObjectsAddressIPobject (ObjectsAddressIP)valueTypestring    Valid values[
  "ip"
]
value Array of string (IP)   Min items1Max items1string  (ipv4)    

ObjectsAddressIPListobject (ObjectsAddressIPList)valueTypestring    Valid values[
  "list"
]
value Array of string (IP)   

Must be a unique list of IPs

Min items1string  (ipv4)    

ObjectsAddressCIDRobject (ObjectsAddressCIDR)valueTypestring    Valid values[
  "cidr"
]
value Array of string (CIDR)   Min items1Max items1string    Pattern^((?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3})(\/(3[0-2]|[1-2][0-9]|[0-9]))$

ObjectsAddressFQDNobject (ObjectsAddressFQDN)valueTypestring    Valid values[
  "fqdn"
]
value Array of string (FQDN)   Min items1Max items1string    Pattern(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)

401

Unauthorized

403

Forbidden

409

Conflict - You cannot delete an address that is associated with one or more policies