Update Group User — Mercoa

Update entity user for all entities in the group.

Path parameters

entityGroupIdstringRequired

Entity Group ID or Entity Group ForeignID

foreignIdstringRequired

ID used to identify user in your system

Request

This endpoint expects an object.

foreignIdstringRequired

The ID used to identify this user in your system. This is a required field and needs to be unique for all users in the group.

emailstringOptional

namestringOptional

entitieslist of objectsOptional

List of roles per entity. By default, the user will have no roles.

Response

This endpoint returns an object.

foreignIdstring

The ID used to identify this user in your system.

entitieslist of objects

List of roles per entity.

createdAtdatetime

updatedAtdatetime

emailstringOptional

namestringOptional

1 curl -X POST https://api.mercoa.com/entityGroup/entg_8545a84e-a45f-41bf-bdf1-33b42a55812c/user/MY-DB-ID-12345 \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "foreignId": "MY-DB-ID-12345", 6 "email": "john.doe@acme.com", 7 "name": "John Doe", 8 "entities": [ 9 { 10 "roles": [ 11 "admin", 12 "approver" 13 ], 14 "entityId": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d" 15 }, 16 { 17 "roles": [ 18 "viewer" 19 ], 20 "entityId": "ent_9e02a20e-7749-47de-8d8a-f8ff2859fa90" 21 } 22 ] 23 }'

1 { 2 "foreignId": "MY-DB-ID-12345", 3 "entities": [ 4 { 5 "entityId": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d", 6 "id": "user_ec3aafc8-ea86-408a-a6c1-545497badbbb", 7 "roles": [ 8 "admin", 9 "approver" 10 ] 11 }, 12 { 13 "entityId": "ent_9e02a20e-7749-47de-8d8a-f8ff2859fa90", 14 "id": "user_3a3aafc8-ea86-408a-a6c1-545497badbbb", 15 "roles": [ 16 "viewer" 17 ] 18 } 19 ], 20 "createdAt": "2024-01-01T00:00:00Z", 21 "updatedAt": "2024-01-01T00:00:00Z", 22 "email": "john.doe@acme.com", 23 "name": "John Doe" 24 }

1	curl -X POST https://api.mercoa.com/entityGroup/entg_8545a84e-a45f-41bf-bdf1-33b42a55812c/user/MY-DB-ID-12345 \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"foreignId": "MY-DB-ID-12345",
6	"email": "john.doe@acme.com",
7	"name": "John Doe",
8	"entities": [
9	{
10	"roles": [
11	"admin",
12	"approver"
13	],
14	"entityId": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d"
15	},
16	{
17	"roles": [
18	"viewer"
19	],
20	"entityId": "ent_9e02a20e-7749-47de-8d8a-f8ff2859fa90"
21	}
22	]
23	}'