---
title: "Service: /members/{member}/groups/{group}/groupfolders/{groupfolderid} [DELETE]"
source: https://dev.pageseeder.com/api/services/groupfolder-DELETE.html
description: "DELETE service that removes group folder sharing from specified groups. Requires project manager access. Returns the updated group folder with remaining sharing status. Supports comma-separated group names as parameters."
last_updated: 2026-09-02T11:36:00+10:00
document_type: api_endpoint
operation_id: groupfolder-DELETE
resource_id: groupfolder
path_template: /members/{member}/groups/{group}/groupfolders/{groupfolderid}
http_method: DELETE
api_category: groupfolder
implementation_version: 6.2004
api_since: 5.9400
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~1020
---

# /members/\{member\}/groups/\{group\}/groupfolders/\{groupfolderid\} \[DELETE\]

## Description

Removes the [group folder](../../reference/glossary/group_folder.md) from the specified groups.

> **Note:** The \{group\} in the service URL must be the owner group unless it is the same as the groups parameter, in which case it can be any of the groups the group folder is shared to.

### Usage examples

To stop sharing the `images` folder within the `acme-specs` group with the `team-marketing` group, you can make the following API request (newlines added for readability only) - assuming member ID is 123 and group folder ID is 456:

```
DELETE https://example.org/ps/api/members/123/groups/acme-specs/groupfolders/456.json
?groups=team-marketing
```

Or 

```
DELETE https://example.org/ps/api/members/123/groups/team-marketing/groupfolders/456.json
?groups=team-marketing
```

To stop sharing the `images` folders within the `acme-specs` group with other groups, you can only make the following API request (newlines added for readability only):

```
DELETE https://example.org/ps/api/members/123/groups/acme-specs/groupfolders/456.json
?groups=team-marketing,team-media
```

Alternatively, you could also use the [PATCH service](groupfolder-PATCH.md), if you don’t want to list the groups to remove:

```
PATCH https://example.org/ps/api/members/123/groups/acme-specs/groupfolders/456.json?groups=
```

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| groups | The groups the folder is to be unshared from – comma-separated list of names | yes | strings |  |

### groups

This parameter lets you specify the list of groups that the groups folder is no longer be shared to as a comma-separated list of group names. The names must not include `admin`, `public` or the owner group specified in the service URL as `{group}`.

You must have project manager access to each of the specified groups and groups can only be specified once for each parameters and cannot be specified for both.

## Permission

Only project managers or administrators can invoke this service.

## Response

If successful, the group folder that was deleted is returned as `<groupfolder>` element wrapped in a `<groupfolder-delete>` element.

```xml
<groupfolder-delete>
  <groupfolder 
            id="[groupuri id]"
            scheme="[scheme]"
            host="[host]"
            port="[port]"
            path="[path]"
            external="[true|false]"
            sharing="[private|shared]">
    <sharing status="[private|shared]" 
                 [hidden="2"] 
                 [public="true"]>
      <share editable="true" 
             shareedits="true"
             sharexrefs="true"
             addcomments="true" 
             owner="true">
        <group name="my-group1" .../>
      </share>
      <share editable="true" 
             shareedits="false" 
             sharexrefs="true" 
             addcomments="false">
        <group name="my-group2" .../>
      </share>
      <share editable="false" 
             shareedits="true" 
             sharexrefs="false" 
             addcomments="true">
        <group name="my-group3" .../>
      </share>
    </sharing>
  </groupfolder>
</groupfolder-delete>
```

Or in JSON

```json
{
  "groupfolder": { 
    "id": number,
    "scheme": string,
    "host": string,
    "port": number,
    "path": string,
    "external": boolean,
    "public": boolean,
    "sharing": string,
    "sharing": {
      "status": string,
      "share":[
        {
          "owner": boolean,
          "editable": boolean,
          "addcomments": boolean,
          "shareedits": boolean,
          "sharexrefs": boolean,
          "group": group
        }
      ]
    }
  }
}
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x1406 | If the group folder id not found |
| 0x1408 | If the group folder id not shared to group |
| 0x140D | Invalid group |
| 0x140E | Group folder not owned by or shared to group |
| 0x1410 | The groups parameter can not contain the owner group |