REST API: Add Group to Site

[mlorentz]

Hi everyone,

In the frontend of Alfresco DMS we can add a group to a site with for example role = "SiteContributor", so therefore all users within the group has access with this specific right for the site. I wasn't able to find the endpoint in the alfresco api explorer. I looked up for /sites/:id/groups or /groups/:id/sites, but I wasn't lucky. Also I tried PUT /nodes/:id with permissions, but I can't see an effect on the frontend.

Do I miss something? Could you help me please?

[abhinavmishra14 · Accepted solution]

You can use this REST API to add groups to a site:

POST /alfresco/service/api/sites/{shortname}/memberships

'shortname' is the shortname of the web site, 'authorityname' is the full authority name for the membership. Required parameters,

role, mandatory String, the new role name for this membership.

person object, with userName property

OR group object, with fullName property

OR authority object, with fullName property

The web script description document specifies the following options:

Value	Description
json	The default response format
user	The authentication access
required	The transaction level
argument	The format style

Example: 

POST: http://localhost:8080/alfresco/service/api/sites/test/memberships

'test', is a site short name.

JsonPayload:

{
  "role" : "SiteContributor",
  "group" : {
      "fullName":"GROUP_EngineeringTeam"
  }
}

Make sure you add 'GROUP_' prefix to the group name you want to add to the site.

You should be getting response something like:

{
    "role": "SiteContributor",
    "authority": {
        "authorityType": "GROUP",
        "shortName": "EngineeringTeam",
        "fullName": "GROUP_EngineeringTeam",
        "displayName": "EngineeringTeam",
        "url": "/alfresco/service/api/groups/EngineeringTeam"
    },
    "url": "/alfresco/service/api/sites/test/memberships/GROUP_EngineeringTeam"
}

[mlorentz]

That's perfect, thank you so much for this example!