put https://{host}/api_gateway/cortex/v1/dataFields/
This API allows you to update data fields that you defined for the org.
Note:
For detailed information about the APIs and for hands-on testing, refer to the API overview documentation and the step-by-step guide on making your first API call.
Prerequisites
- Authentication: Basic/OAuth authentication
- Default access group
Resource Information
| URI | /api_gateway/cortex/v1/dataFields/{id} |
| HTTP method | PUT |
| Pagination | NA |
| Rate limit | Default |
| Batch support | NA |
API Endpoint Example
https://eu.api.capillarytech.com/api_gateway/cortex/v1/dataFields/67e6a8bfdd6a186b5555ba98
Query Parameter
| Parameter | Data Type | Description |
|---|---|---|
| id* | String | Data Field identifier that you received in the response during the creation of the datafield. |
Request Parameters
| Parameters | Data type | Description |
|---|---|---|
| searchStrategyType* | String | Defines the search strategy type (COMBINATION, PREFIX) |
| entityType* | Enum | Type of entity being searched (TRANSACTION, CUSTOMER) |
| dataFieldDefinitions* | Array | List of field definitions used in the search. |
| - fieldId* | String | The field to search on. For Customer, the supported standard fields are: firstName, lastName, email, mobile, externalId, and fullName.For Transaction, the supported fields are: outlierStatus, billDate, billNumber, and storecode (additional field). |
| - fieldAlias | String | The alias or display name of the field |
| - fieldType | Enum | Type of field. Use the value DATA |
| - dataSourceDetails | Object | Contains details about the data source. |
| -- fieldReference | String | Applicable when using custom fields or extended fields. Ex: extendedFields.ship_email, customFields.age. If you are using store code to search, use additionalFields.storecode (applicable for transaction). |
| - dataType | String | Data type of the field (STRING, NUMBER, DECIMAL, or DATE). |
curl --location --request PUT 'https://eu.api.capillarytech.com/api_gateway/cortex/v1/dataFields/67e6a8bfdd6a186b5555ba98' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic cHJlcmFuYV9naDoyZmFhZmZjNjY5ZDRjMTc5Y2NlMzNhYzc5OTBjMTQ1Ng==' \
--header 'Cookie: _cfuvid=257QQtZKKeLsnIKUrPVpHcKPHvi2s4LSYFlH8VLHtc0-1743065149089-0.0.1.1-604800000; _cfuvid=cryFX5AeUyWVtFaBgq_5BT7fv.XNzDRf_OtNgx6a9oA-1743493240591-0.0.1.1-604800000' \
--data '{
"searchStrategyType": "PREFIX",
"entityType": "TRANSACTION",
"dataFieldDefinitions": [
{
"fieldId": "lastName",
"fieldAlias": "lastName",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "lastName"
},
"dataType": "STRING"
},
{
"fieldId": "mobile",
"fieldAlias": "mobile",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "mobile"
},
"dataType": "STRING"
},
{
"fieldId": "email",
"fieldAlias": "email",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "email"
},
"dataType": "STRING"
},
{
"fieldId": "externalId",
"fieldAlias": "externalId",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "externalId"
},
"dataType": "STRING"
}
],
"errors": [
}
curl --location 'eu.api.capillarytech.com/api_gateway/cortex/v1/dataFields' \
--header 'Authorization: Basic bmVlcmFqLmRvNGFmDA0MDA5Y2IwMzZhNGNjZGMzMzQzMWVmOWFjOQ==' \
--header 'Content-Type: application/json' \
--header 'Cookie: _cfuvid=NIG4hPIouTlCOXgwODX50uFuouza2nwDNThbawZibQM-1743137683215-0.0.1.1-604800000' \
--data '{
"searchStrategyType" : "PREFIX",
"entityType" : "CUSTOMER",
"dataFieldDefinitions" : [
{
"fieldId" : "firstName",
"fieldAlias" : "firstName",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "firstName"
},
"dataType" : "STRING"
},
{
"fieldId" : "lastName",
"fieldAlias" : "lastName",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "lastName"
},
"dataType" : "STRING"
},
{
"fieldId" : "mobile",
"fieldAlias" : "mobile",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "mobile"
},
"dataType" : "STRING"
},
{
"fieldId" : "email",
"fieldAlias" : "email",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "email"
},
"dataType" : "STRING"
},
{
"fieldId" : "externalId",
"fieldAlias" : "externalId",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "externalId"
},
"dataType" : "STRING"
}
]
}'
Response Body Parameters
| Parameter | Data Type | Description |
|---|---|---|
| id | String | Unique Identifier of the data |
| orgId | Integer | The ID of the organization associated with the criteria |
| searchStrategyType | Enum | Defines the search strategy type (`COMBINATION, PREFIX ) |
| entityType | Enum | Type of entity being searched (TRANSACTION , CUSTOMER) |
| dataFieldDefinitions | Array | List of field definitions used in the search. |
| - fieldId | String | Unique identifier for the field. |
| - fieldAlias | String | The alias or display name of the search field. |
| - fieldType | Enum | Type of field (e.g., INDEXED, FILTERABLE). |
| - dataSourceDetails | Object | Contains details about the data source. |
| -- fieldReference | String | The reference to the search field in the data source. |
| - dataType | String | Data type of the field (e.g., STRING, DATE). |
| auditInfo | Object | An object containing audit information about the criteria. |
| - createdOn | String | The timestamp indicating when the criteria was created. |
| - createdBy | Integer | The ID of the user who created the criteria. |
| - lastUpdatedOn | String | The timestamp indicating when the search criteria was last updated. |
| - lastUpdatedBy | Integer | The ID of the user who last updated the criteria. |
{
"searchStrategyType" : "PREFIX",
"entityType" : "CUSTOMER",
"dataFieldDefinitions" : [
{
"fieldId" : "firstName",
"fieldAlias" : "firstName",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "firstName"
},
"dataType" : "STRING"
},
{
"fieldId" : "lastName",
"fieldAlias" : "lastName",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "lastName"
},
"dataType" : "STRING"
},
{
"fieldId" : "mobile",
"fieldAlias" : "mobile",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "mobile"
},
"dataType" : "STRING"
},
{
"fieldId" : "email",
"fieldAlias" : "email",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "email"
},
"dataType" : "STRING"
},
{
"fieldId" : "externalId",
"fieldAlias" : "externalId",
"fieldType" : "DATA",
"dataSourceDetails" : {
"fieldReference" : "externalId"
},
"dataType" : "STRING"
}
]
}
{
"data": {
"id": "67ebcbe9730aa850fc504145",
"orgId": 100737,
"searchStrategyType": "COMBINATION",
"entityType": "TRANSACTION",
"dataFieldDefinitions": [
{
"fieldId": "billNumber",
"fieldAlias": "billNumber",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "billNumber"
},
"dataType": "STRING"
},
{
"fieldId": "billDate",
"fieldAlias": "billDate",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "billDate"
},
"dataType": "DATE"
},
{
"fieldId": "storename",
"fieldAlias": "storename",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "additionalFields.storename"
},
"dataType": "STRING"
},
{
"fieldId": "storecode",
"fieldAlias": "storecode",
"fieldType": "DATA",
"dataSourceDetails": {
"fieldReference": "additionalFields.storecode"
},
"dataType": "STRING"
}
],
"auditInfo": {
"createdOn": "2025-04-01T11:20:09.793+00:00",
"createdBy": 75155282,
"lastUpdatedOn": "2025-04-01T11:20:09.793+00:00",
"lastUpdatedBy": 75155282
}
},
"errors": []
}
API Endpoint
{host}/api_gateway/cortex/v1/dataFields/{id}