ADR: Ability to add multiple members under single entitlement group in one go

Entitlements service enables authorization in OSDU Data Ecosystem. The service allows for the creation of groups. Users who are added to the entitlement group get the permission.

More can be read about the current API here .

Problem :

Today, entitlement service's add member API, adds single user at a time. When user wants to give permission to multiple users at the same time, then to add n number of users, the API need to be called for n times.

This increases API calls , latency . This also puts an overhead to write extra logic to handle partial success/failure cases .

Possible Solution

We would like to have enhancement in the current API to add multiple users under one entitlement group in one go.

Instead of accepting single user in the request payload, API could accept array of users.

[

{ "email": "member@{domain}.com", "role": "MEMBER" },

{ "email": "member@{domain}.com", "role": "MEMBER" },

{ "email": "member@{domain}.com", "role": "OWNER" }

]

Consequences

• This will help users to bring atomicity in entitlement group modification while adding multiple users
• This will improve performance by reducing latency time
• This will help to have lesser API calls and hence lesser chance of hitting rate limits