# Fetches the list of custom groups available for SSP publishing

Retrieves custom groups that can be used to publish software packages in the self service portal, filtered by publish type (computer or user).

## Endpoints

`GET /dcapi/swDeployment/publish/groupList`

## Request

### Request URL

https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/swDeployment/publish/groupList

### Scope

`DesktopCentralCloud.SWDeployment.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — Mandatory
  - `application/publishGroupList.v1+json`

#### Query Parameters

- **searchValue** `string` — Optional
  - Optional search string to filter groups by name
- **publishType** `string` — Mandatory
  - Required. Values: computer or user.

### Sample Request

```curl
curl --request GET \
  --url 'https://appdomains/dcapi/swDeployment/publish/groupList?publishType=SOME_STRING_VALUE' \
  --header 'Accept: application/publishGroupList.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — `application/json`

- `JSON Object`
  - **cgDetailsList** `JSON Array`
    - Array of custom groups available for SSP publishing

### HTTP Code 500

#### Response Body — `application/json`

- `JSON Object`
  - **errorCode** `string`
    - `INTERNAL_ERROR` for publish/modify failures, `SW_INTERNAL_ERROR` for SSP configuration errors
  - **errorMessage** `string`
    - Internal server error with details about the SSP publish or group operation failure

### Possible Response Codes

- **200** — HTTP code
- **500** — HTTP code

### Sample Response: HTTP 200

Available groups

```json
{
  "cgDetailsList": [
    {
      "groupName": "Engineering Workstations",
      "groupType": 1,
      "groupResourceId": 301
    }
  ]
}
```

### Sample Response: HTTP 500

Server error

```json
{
  "errorMessage": "Internal Server Error",
  "errorCode": "INTERNAL_ERROR"
}
```

## Rate Limits

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 100 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.