Web Service Documentation / Categories / Basic Account Services / Edit Custom Field

Edit Custom Field

Updated on May 9, 2014

Description

This web service updates a specified custom field. This custom field is used by the data exchange web services during the connection/share process.

Version

23.0

HTTP Method

PUT

Resource URL

/dataExchangeSettings/customField/(customFieldId)

Header

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

Authorization Required

Yes

Parameters

Parameter Name Description
customFieldId Id to the custom field

XML Schemas

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

Example Request

The following example updates a custom field that has an id of 46.

PUT  /dataExchangeSettings/customField/46

<?xml version="1.0" encoding="UTF-8"?> <customField whenToPrompt="Property" name="FG ID" required="true" validCharacters="Any"> <minChars>1</minChars> <maxChars>12</maxChars> <description>Federal ID</description> <example>FG 323</example> <displayOrder>1</displayOrder> <url>http://www.acme.com</url> </customField>

Example Response

The following example indicates that the custom field was successfully updated. It also returns the new custom field id of 46 and a link to web service to retrieve the custom field.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
    <id>46</id>
    <links>
        <link httpMethod="GET" link="/dataExchangeSettings/customField/46" linkDescription="This is the GET url for this custom field."/>
    </links>
</response>
LIVE