Overview
This endpoint can be used to update the existing custom company settings of a specific company.
To consume the endpoint, you must:
- Be an authenticated user.
For information on how you can authenticate, see Authentication.
After you authenticate and receive a valid token, you must pass it to service calls.
Endpoint
An example of this endpoint for XX server is:
- https://XX.api.sellercloud.com/rest/api/Companies/{id}/CustomSettings
For your server, the endpoint will be:
- https://{your_server_id}.api.sellercloud.com/rest/api/Companies/{id}/CustomSettings
Request
- Method Type: HttpPut
- Authorization: Use Bearer Token + token received from token authentication
- Header info: Content-Type: application/json
Request Body
The request must include a list of custom company settings. The body parameters define each setting’s name, value, and masking.
| Parameter | Parameter Type | Data Type | Description | Required |
| id | path | integer | ID of the targeted company. | yes |
| SettingName | body | string | Custom company setting name. | yes |
| SettingValue | body | string | Custom company setting value.
Set to “null” if no update is needed. |
yes |
| MaskValue | body | boolean | Show or hide the setting value.
Set to “null” if no update is needed. |
yes |
The request body should be formatted as follows:
{
"CustomSettings": [
{
"SettingName": "string",
"SettingValue": "string",
"MaskValue": true
}
]
}
Response
- If the user is authenticated and the request is successful, the response is Status Code 200 => OK
- If the user is not authenticated, the response is Status Code 401 => Invalid Token
- In case of an error, the response is Status Code 500 => Internal Server Error
- In case of an incorrect request, the response is Status Code 400 => Bad Request
