# 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).

## Endpoint

`GET /dcapi/swDeployment/publish/groupList`

## Request Details

### Request URL

`https://{server-hostname}:8383/dcapi/swDeployment/publish/groupList`

### Scope

`SWDeployment.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

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

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/swDeployment/publish/groupList \
  --header 'Accept: application/publishGroupList.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

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

`JSON Object`

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

### Sample Response: HTTP 200

Available groups

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

### 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

### Sample Response: HTTP 500

Server error

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

### Possible Response Codes

- **200** `HTTP code`
- **500** `HTTP code`

## 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.