updateTabularRecords

Purpose

You can use the updateTabularRecords method to update particular tabular entries of a specified record.

Type: POST

URL Format
https://recruit.zoho.com/recruit/private/xml/<module_name>/updateTabularRecords?authtoken=<authtoken>&id=<record_id>&xmlData =<Xml_Data >&scope=recruitapi

For OAuth Authentication

Header Name	Value
Authorization	Zoho-oauthtoken {access_token}

Scopes

Scope=ZohoRecruit.modules.all

(or)

Scope=ZohoRecruit.modules.{scope_name}.{operation_type}

Possible Scope Names (Case Sensitive)	Operation Types
referral, campaign, assessment, vendor, offer, attachment,  forecast, note, call, event, task, candidate, jobopening, client, department, interview, contact & custom (for all Custom Modules)	ALL - Full access to the record READ - Get records from the module

For Authtoken Authentication

Parameter	Data Type	Description
authtoken*	String	Encrypted alphanumeric string to authenticate your Zoho credentials.
scope*	String	Specify the value as recruitapi

Request Parameters

Parameter	Data Type	Description
id*	String	Specify the unique ID of the record
xmlData*	XML	Tabular data to be updated to a record

Note: Parameters marked with * are mandatory

Sample Request

https://recruit.zoho.com/recruit/private/xml/Candidates/updateTabularRecords?authtoken=<authtoken>&id=<candidateid>&xmlData=<?xml version="1.0" encoding="UTF-8"?> <Candidates><FL val="Experience Details"><TR no="0"><TL val="TABULARROWID"><![CDATA[368078000002922007]]></TL><TL val="Occupation /Title"genType="1"uiType="1"><![CDAT A[Ja va Developer - Mooresville, NC]]></TL><TL val="Company" genType="1" uiType="1"><![CDATA[Lowe's]]></TL><TL val="Summary" genType="1" uiType="110"><![CDATA[test]]></TL><TL val="Work Duration_From" genType="1" uiType="6607"><![CDATA[01-2015]]></TL><TL val="I currently work here" 

genType="1" uiType="301"><![CDATA[false]]></TL></TR></FL></Candidates> 

Response

<?xml version="1.0" encoding="UTF-8"?>
<response uri="/recruit/private/xml/Candidates/updateTabularRecords"> 

<result>
<Candidates>Record(s) updated successfully</Candidates> 

</result> </response> 

Note:

1. If there isn't any record with matching with the specified tabular row id, the data will be treated as new and will be added as a tabular entry along with the existing data.
   
2. To update two or more values on to multi picklist fields, use semicolon (;) as the separator.
   Example: <![CDATA[Option 1;Option 2;Option 3]]>

• Related Articles

• API Methods

  Method Name Purpose getRecords To retrieve all users data specified in the API request getRecordById To retrieve individual records by record ID addRecords To insert records into the required Zoho Recruit module updateRecords To update or modify the ...