> For the complete documentation index, see [llms.txt](https://klearstack.gitbook.io/klearstack-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://klearstack.gitbook.io/klearstack-api-documentation/fields-setting/update-field-mapping.md).

# Update Field Mapping

Endpoint Name: `URL/klearstack/updatemappingdataapi`

Request type : `POST`

Authorization: Bearer token as header

Endpoint Details: The `updatemappingdataapi` endpoint will be used to update enable / disable fields or update the settings of fields.

<table data-header-hidden><thead><tr><th width="119"></th><th></th></tr></thead><tbody><tr><td>Method</td><td>URL</td></tr><tr><td>POST</td><td><code>URL/klearstack/updatemappingdataapi</code></td></tr></tbody></table>

### Request Body

<table data-header-hidden><thead><tr><th width="187"></th><th width="84"></th><th width="101.181884765625"></th><th></th></tr></thead><tbody><tr><td>Params</td><td>Values</td><td>Required</td><td>Description</td></tr><tr><td>company_name</td><td>string</td><td>Yes</td><td>Name of the company for which the user is logging in</td></tr><tr><td>username</td><td>string</td><td>Yes</td><td>User Name</td></tr><tr><td>collection_name</td><td>string</td><td>Yes</td><td>Document Type</td></tr><tr><td>data</td><td><br></td><td>Yes</td><td><p>[{</p><p>  "documentTypeDetails": {</p><p>    "invoices": {</p><p>      "fields": {</p><p>        "doc_number_value": {</p><p>          "label": "Invoice Number",</p><p>          "required": true,</p><p>          "visibility": true</p><p>        }</p><p>      }</p><p>    }</p><p>  }</p><p>}]</p></td></tr></tbody></table>

### Shell (cURL)

* Request Body

```sh
curl --location "URL/klearstack/updatemappingdataapi" \
  --header "Authorization: Bearer your_token_here" \
  --form "company_name=Replace_Company_Name_Here" \
  --form "username=Replace_Username_Here" \
  --form "collection_name=Replace_Collection_Name_Here" \
  --form 'data=[{
    "documentTypeDetails": {
      "invoices": {
        "fields": {
          "doc_number_value": {
            "label": "Invoice Number",
            "required": true,
            "visibility": true
          }
        }
      }
    }
  }]'
```

### Python

* Request Body

```python
import requests

url = "URL/klearstack/updatemappingdataapi"

payload = {'company_name': 'Replace_Company_Name_Here',
'username': 'Replace_Username_Here',
'collection_name': 'Replace_Collection_Name_Here',
'data': '[{
    "documentTypeDetails": {
      "invoices": {
        "fields": {
          "doc_number_value": {
            "label": "Invoice Number",
            "required": true,
            "visibility": true
          }
        }
      }
    }
  }]'}
files=[

]
headers = {
  'Authorization': 'Bearer your_token_here'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

```

### Java (OkHttp)

* Request Body

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("company_name", "Replace_Your_Company_Name_Here")
  .addFormDataPart("username", "Replace_Your_Username_Here")
  .addFormDataPart("collection_name", "Replace_Your_Collection_Name_Here")
  .addFormDataPart("data", "[{\n" +
    "  \"documentTypeDetails\": {\n" +
    "    \"invoices\": {\n" +
    "      \"fields\": {\n" +
    "        \"doc_number_value\": {\n" +
    "          \"label\": \"Invoice Number\",\n" +
    "          \"required\": true,\n" +
    "          \"visibility\": true\n" +
    "        }\n" +
    "      }\n" +
    "    }\n" +
    "  }\n" +
    "}]")
  .build();
Request request = new Request.Builder()
  .url("URL/klearstack/updatemappingdataapi")
  .method("POST", body)
  .addHeader("Authorization", "Bearer Replace_Your_Token_Here")
  .build();
Response response = client.newCall(request).execute();
```

### Node.js (Axios)

* Request Body

```javascript
const axios = require('axios');
const FormData = require('form-data');

let formData = new FormData();
formData.append('company_name', 'Replace_Your_Company_Name_Here');
formData.append('username', 'Replace_Your_Username_Here');
formData.append('collection_name', 'Replace_Your_Collection_Name_Here');
formData.append('data', '[{\r\n    "documentTypeDetails": {\r\n      "invoices": {\r\n        "fields": {\r\n          "doc_number_value": {\r\n            "label": "Invoice Number",\r\n            "required": true,\r\n            "visibility": true\r\n          }\r\n        }\r\n      }\r\n    }\r\n  }]');

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'URL/klearstack/updatemappingdataapi',
  headers: { 
    'Authorization': 'Bearer Replace_Your_Token_Here', 
    ...formData.getHeaders()
  },
  data: formData
};

axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });
```

### JavaScript (XHR)

* Request Body

```javascript
// WARNING: For POST requests, body is set to null by browsers.

var formData = new FormData();
formData.append("company_name", "Replace_Your_Company_Name_Here");
formData.append("username", "Replace_Your_Username_Here");
formData.append("collection_name", "Replace_Your_Collection_Name_Here");
formData.append("data", "[{\r\n    \"documentTypeDetails\": {\r\n      \"invoices\": {\r\n        \"fields\": {\r\n          \"doc_number_value\": {\r\n            \"label\": \"Invoice Number\",\r\n            \"required\": true,\r\n            \"visibility\": true\r\n          }\r\n        }\r\n      }\r\n    }\r\n  }]");

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "URL/klearstack/updatemappingdataapi");
xhr.setRequestHeader("Authorization", "Bearer Replace_Your_Token_Here");

xhr.send(formData);
```

### API Response

<table data-header-hidden><thead><tr><th width="147"></th><th></th></tr></thead><tbody><tr><td>Status code</td><td>Example Response</td></tr><tr><td>200</td><td>Request Submitted Successfully</td></tr></tbody></table>