Managed MSP
Call description
Use this request to change or update the properties of an existing company.
•This API call requires authorization; the user has to be logged in.
•Request URL: https://mspapi.eset.com/api/Company/Update/managedmsp
•This request is a POST call type.
How Update calls work
When updating the company properties using an Update call:
•Each value in the Update request replaces the existing value in the updated object (company).
•Parameters with no value (but not excluded from the request) erase the original value in the updated object.
•If the parameter is excluded (omitted) in the call, the updated object keeps the original value for that parameter.
The companyId parameter is used to identify the company to update. It is the only mandatory parameter in Update calls.
Call structure
{
"name": "string",
"companyId": "string",
"address": {
"state": "string",
"city": "string",
"streetAddress": "string",
"zipCode": "string"
},
"tagsToAdd": [
{
"tag": "string"
}
],
"tagsToRemove": [
{
"tag": "string"
}
],
"customIdentifier": "string",
"comment": "string",
"vatId": "string",
"description": "string",
"email": "string",
"trialLicenseAllowed": true,
"productsToAdd": [
{
"code": "string"
}
],
"productsToRemove": [
{
"code": "string"
}
],
"trusted": true,
"acceptPendingRequests": true
}
Call parameters
Parameter |
Description |
|---|---|
Email address of the user. |
|
trialLicenseAllowed |
Set if trial licenses are allowed for the new user. Use values: true / false. |
productsToAdd, productsToRemove, products, code |
You can type in one or more product codes to add them (productsToAdd) or remove them (productsToRemove) from the company's selection. |
address |
Section for the user address information. |
state |
User address state of residence. Select one from the list. |
city |
User address city of residence. |
streetAddress |
User address street name. |
zipCode |
User address ZIP code. |
tagsToAdd, tagsToRemove |
tagsToRemove and tagsToAdd are update parameters; you can type in tags to be removed or added to the updated entity. Type one or more tags. |
customIdentifier |
Identifier string. |
comment |
Comment field. |
vatId |
VAT ID or TAX ID number. If your company has selected USA as the country of residence, it uses TAX ID. The request body always uses VAT ID, but the MSP Web portal (EMA 2) displays the correct field. |
description |
Description field. |
name |
The company name; a unique identifier for entities across EMA 2. Mandatory input parameter. A proper value must be set. |
companyId |
companyId is the unique identifier of the company you are updating. You cannot update or change the id value. Mandatory input parameter. A proper value must be set. |
trusted |
Update the Managed MSP to the trusted status (can order licenses without approval). Allowed values: true / false. |
acceptPendingRequests |
When converting a Managed MSP from untrusted to trusted ("trusted":true), the Managed MSP's already existing license requests are all accepted (true) or declined (false). When converting a Managed MSP from trusted to untrusted, the parameter is ignored. The pending requests are processed in the background. High number of pending requests can take longer time to finish. The default value is false. Allowed values: true / false. |
Response structure
A successful call returns an empty JSON response.
Troubleshooting
ESET MSP Administrator 2 API uses standardized error codes. If you are getting errors or unexpected responses, see the Troubleshooting API for common problems and the list of error codes.