announcement

During the current lapse in appropriations, EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. Many services may not be available during this time.

Web Service Documentation / Categories / Property Services / Edit Property Identifier Value

Edit Property Identifier Value

Updated on July 17, 2013

Description

This web service updates the property identifier value for a specific property based on the information provided in the XML request.

Version

25.0

HTTP Method

PUT

Resource URL

/property/(propertyId)/identifier/(identifierId)

Header

Field Name Value Comments
Authorization Basic credentials
Content-Type application/xml

Authorization Required

Yes

Parameters

Parameter Name Description
propertyId Id of the property

XML Schemas

Request/Response Schema Name
Request additionalIdentifier.xsd
Response response.xsd

Example Request

The following example assigns the value "EAST100" to the property identifier that has an id of 64 and identifier type id of 4 for the property with an id of 32423.

PUT  /property/32423/identifier/64

<?xml version="1.0" encoding="UTF-8"?>
<additionalIdentifier>
    <additionalIdentifierType id="4"/>
    <description>Description</description>
    <value>EAST100</value>
</additionalIdentifier>

Example Response

The following example indicates that the property identifier value was updated successfully.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
    <id>64</id>
    <links>
        <link httpMethod="GET" link="/property/32423/identifier/64" linkDescription="This is the GET url for this Property Additional Identifier."/>
    </links>
</response>
LIVE