Update a custom field configuration (PUT)


The PUT command updates an existing custom field by using the XML representation of this field and modifying its content.

Command overview

Method — PUT
 Resource — customfield
 Resource identifier — Integer that identifies the custom field (custom field ID)

Parameters

Parameter

Description

Example

usr 1

A valid system user name (case sensitive)

usr=myUsername

pwd 1

The password that corresponds to the usr (user name) parameter (case sensitive)

pwd=myPassword
tid

The transaction identifier. You must specify the tid for all stateful operations. Do not include it in stateless operations.

tid=5456

 1 This parameter is required.

Sample request

https://10.0.0.1/rest/configurationapi/customfieldapi/1.0/customfield/123?usr=jdoe&pwd=pa55w0rd!&tid=4738
...
<customField active="false" entity="object" srcEntity="object" type="string" policy="first-non-null" export="x- custom-gzip" grammar="custom_gzip">
 <name><![CDATA[Text Compression]]></name>
 <description><![CDATA[Tracking all gzip text compression]]></ description>
<extractions>
 <extraction>
  <name><![CDATA[Text Objects]]></name>
  <expression><![CDATA[(mime_type contains "text" ignorecase)]]></expression>
  <source>
   <sourceHTTPHeader origin="response" index="0" indexType="all" characterLimit="50">
    <key><![CDATA[Content-Encoding]]></key>
   </sourceHTTPHeader>
  </source>
  <transformations/>
  </extraction>
 </extractions>
</customField>

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
 <status result="success"></status>
</response>

Related topic

Custom-field-API-XML-reference

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*