# Publish a configuration profile for deployment Publishes a configuration profile, making it available for distribution to devices and groups. The profile status changes to 110 (Published). Cannot publish an already-published profile. ## Endpoint **POST** `/bsp/api/v1/bmp/profiles/{profile_id}/publish` ## Request ### Request URL `https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/bsp/api/v1/bmp/profiles/{profile_id}/publish` ### Scope `DesktopCentralCloud.BrowserManager.CREATE` ### Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ### Request Parameters #### Request Headers - **Content-Type** `string` — **Mandatory** `application/json` - **Accept** `string` — **Mandatory** `application/json` #### Path Parameters - **profile_id** `string` — **Mandatory** Retrieve the configuration profile ID from the `profileid` key in the response returned by [List Configuration Profiles](https://www.manageengine.com/products/desktop-central/help/api/cloud/profiles-list-profiles.html). #### Request Body JSON body with profile ID and platform type for publishing. `application/json` **JSON Object** Request body for publishing a configuration or web sandboxing profile. - **PROFILE_ID** `string` — Optional Profile ID from [List Configuration Profiles](https://www.manageengine.com/products/desktop-central/help/api/cloud/profiles-list-profiles.html) response (`profileid` field). - **PLATFORM_TYPE** `string` — Optional Target platform type. `'1'` = Windows, `'2'` = Mac. ### Sample Request ```curl curl --request POST \ --url https://appdomains/bsp/api/v1/bmp/profiles/{profile_id}/publish \ --header 'Accept: application/json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \ --header 'Content-Type: application/json' \ --data '{}' ``` ### Sample Request Body Publish a Windows configuration profile. ```json { "PROFILE_ID": 111, "PLATFORM_TYPE": "1" } ``` ## Response Parameters ### HTTP Code 204 Response Body — `application/json` **JSON Object** ### HTTP Code 401 Response Body — `application/json` **JSON Object** - **errorCode** `long` Unauthorized error code: credentials missing, expired, or invalid. - **errorMsg** `string` Authentication failure reason. ### HTTP Code 403 Response Body — `application/json` **JSON Object** - **errorCode** `long` Error code indicating insufficient permissions. - **errorMsg** `string` Message indicating insufficient privileges to access this resource. ### HTTP Code 404 Response Body — `application/json` **JSON Object** Resource not found error. - **errormsg** `string` Not found error message. ### HTTP Code 409 Response Body — `application/json` **JSON Object** Conflict error due to the current state of the profile. - **errormsg** `string` Conflict error message. ### HTTP Code 429 Response Body — `application/json` **JSON Object** - **errorCode** `long` Rate limit error code returned when the API call reached threshold. - **errorMsg** `string` Rate limit exceeded message with retry guidance. ### HTTP Code 500 Response Body — `application/json` **JSON Object** Internal server error response for profile operations. - **error_description** `string` Error message describing the server failure. - **error_code** `string` Error code for internal server errors. ## Possible Response Codes - **204** — Returns 204 No Content on success. - **401** - **403** - **404** - **409** - **429** - **500** ## Sample Responses ### HTTP 204 ```text 204 Returns 204 No Content on success. ``` ### HTTP 401 API key is missing or invalid. ```json { "errorCode": "IAM0001", "errorMsg": "Authentication key is invalid. Please regenerate the key and try again." } ``` ### HTTP 403 Forbidden. ```json { "errorCode": "FORBIDDEN", "errorMsg": "User does not have permission to perform this operation" } ``` ### HTTP 404 Profile to publish does not exist. ```json { "errormsg": "Profile not found" } ``` ### HTTP 409 Profile is already in published state. ```json { "errormsg": "Profile already published." } ``` ### HTTP 429 Rate limit exceeded. ```json { "errorCode": "RATE_LIMIT_EXCEEDED", "errorMsg": "Too many requests. Please try again after 5 minutes" } ``` ### HTTP 500 Server error. ```json { "error_description": "Internal Server error, Please try again in a moment.", "error_code": "COM0004" } ``` ## Rate Limit **Duration:** 1 minute | **Threshold:** 60 | **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.