# Deletes a published SSP group configuration Removes a published group from the self service portal. Both `groupResourceId` and `collectionId` are required to identify the configuration to delete. ## Endpoint `POST /dcapi/swDeployment/publishGroup/delete` ## Request URL https://[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/swDeployment/publishGroup/delete ## Scope `DesktopCentralCloud.SWDeployment.DELETE` ### Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ## Request Parameters ### Request Headers - **Content-Type** `string` **Mandatory**: `application/deletePublishGroup.v1+json` - **Accept** `string` **Mandatory**: `application/deletePublishGroup.v1+json` ### Request Body `application/json` - **groupResourceId** `string` Optional: Resource ID of the custom group. Obtain from the `groupResourceId` field in the response of the [List SSP Publish Groups](https://www.manageengine.com/products/desktop-central/help/api/cloud/self-service-portal-list-publish-groups.html) API. - **collectionId** `string` Optional: Collection ID of the SSP configuration to delete. Obtain from the `collectionId` field in the response of the [Check Custom Group Published](https://www.manageengine.com/products/desktop-central/help/api/cloud/self-service-portal-check-custom-group-published.html) API. ### Sample Request ```curl curl --request POST \ --url https://appdomains/dcapi/swDeployment/publishGroup/delete \ --header 'Accept: application/deletePublishGroup.v1+json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \ --header 'Content-Type: application/deletePublishGroup.v1+json' \ --data '{}' ``` ### Sample Request Body Delete a published SSP group ```json { "collectionId": "5001", "groupResourceId": "301" } ``` ## Response Parameters ### HTTP Code 200 Response Body — `application/json` - **status** `integer`: `0` on success - **statusMsg** `string`: Localized message describing the deletion result ### HTTP Code 401 Response Body — `application/json` - **errorCode** `long`: Unauthorized error code returned when authentication credentials are missing, expired, or invalid (`authentication=required`) - **errorMsg** `string`: Authentication failure reason ### HTTP Code 500 Response Body — `application/json` - **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 - `401` HTTP code - `500` HTTP code ### Sample Response: HTTP 200 Deleted successfully ```json { "statusMsg": "Published group (Engineering Workstations) has been deleted successfully", "status": 0 } ``` ### Sample Response: HTTP 401 No access to delete ```json { "errorMessage": "The user has no access to delete published group.", "errorCode": "ACCESS_DENIED" } ``` ### 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:** 30 | **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.