In this article
POST MEM Master Record Security
Use this endpoint when you want to assign access of master record types to specific entities. You can give access or remove access with the POST request.
For example, with this request you can assign the Customer master record with ID 40000 access to entity 000.
Tip: For the most current and complete API information in Multi-Entity Management, run the following GET command.
GET https://api.businesscentral.dynamics.com/v2.0/<TenantID>/api/binarystream/bssiMem/v1.0/$metadataHTTP Request
POST/ bssiMEMMasterRecordSecurity
Changes the master record type access to a MEM entity.
https://api.businesscentral.dynamics.com/v2.0/<Tenant ID>/<Env Name>/api/binarystream/bssiMem/v1.0/companies(<Company ID>)/bssiMEMMasterRecordSecurityPath Parameters
Review the following table for descriptions of the path parameters.
| Parameter | Required / Optional | Description | Type |
|---|---|---|---|
| Tenant ID | Required | Enter your tenant ID. | GUID |
| Env Name | Required | Enter your environment name. | String |
| Company ID | Required | Enter the company ID. | GUID |
| Query Filters | |||
| $filter | Optional | Use the $filter parameter with any of the filters listed below. | String |
| BssiMasterRecordType | Optional | Enter a master record type that you want to retrieve. | String |
| BssiMasterRecordID | Optional | Enter a master record ID that you want to retrieve. | String |
| BssiEntityID | Optional | Enter an entity ID to retrieve records from a specific entity. | String |
Request Body
{
"BssiMasterRecordType": "",
"BssiMasterRecordID": "",
"BssiEntityID": ""
"BssiAccessible": "",
}Request Body Items
| Item | Required / Optional | Description | Type |
|---|---|---|---|
| BssiMasterRecordType | Required | Enter a master record type that you want to retrieve. | String |
| BssiMasterRecordID | Required | Enter a master record ID that you want to retrieve. | String |
| BssiEntityID | Required | Enter an entity ID to retrieve records from a specific entity. | String |
| BssiAccessible | Required |
Displays whether the user has access to records. True: User has access. False: User does not have access. |
Boolean |
Response
If successful, this method returns a 200 OK response code.
Sample Request
Remove access of the Vendor master record with ID 81000 to entity 200.
POST/ bssiMEMMasterRecordSecurity
https://api.businesscentral.dynamics.com/v2.0/<Tenant ID>/<Env Name>/api/binarystream/bssiMem/v1.0/companies(<Company ID>)/bssiMEMMasterRecordSecuritySample Request Body
{
"BssiMasterRecordType": "Vendor",
"BssiMasterRecordID": "81000",
"BssiEntityID": "200",
"BssiAccessible": false
}Sample Response
{
"@odata.etag": "W/\"JzIwOzE0MTUyMzA5MzczNTgyNzk4OTgzMTswMDsn\"",
"SystemId": "00000000-0000-0000-0000-000000000000",
"BssiMasterRecordType": "Vendor",
"BssiMasterRecordID": "81000",
"BssiEntityID": "200",
"BssiAccessible": false
}Response Definitions
Review the following table for descriptions of the items in the response.
| Response item | Description | Type |
|---|---|---|
| SystemID | Will always be empty. | GUID |
| BssiMasterRecordType | Displays the master record type. | String |
| BssiMasterRecordID | Displays the master record ID. | String |
| BssiEntityID | Displays the entity ID. | String |
| BssiAccessible |
Displays whether the master record type has access to records. True: Has access. False: Does not have access. |
Boolean |
