# Retrieve detailed information about a specific extension Retrieves detailed information about a specific extension including permissions, metadata, install source, homepage URL, update URL, and extension type. ## Endpoint `GET /bsp/api/v1/bmp/extensions/{extension_id}/details` ## Request ### Request URL `https://`[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/bsp/api/v1/bmp/extensions/{extension_id}/details` ### Scope `DesktopCentralCloud.BrowserManager.READ` ### Header `Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52` ### Request Parameters #### Request Headers | Parameter | Type | Required | Value | |---|---|---|---| | Accept | string | Mandatory | application/json | #### Path Parameters | Parameter | Type | Required | Description | |---|---|---|---| | extension_id | string | Mandatory | Extension Profile ID from [List Extensions](https://www.manageengine.com/products/desktop-central/help/api/cloud/extension-management-add-extension.html) response (`extension_id` field) | ### Sample Request #### Curl ```curl curl --request GET \ --url https://appdomains/bsp/api/v1/bmp/extensions/{extension_id}/details \ --header 'Accept: application/json' \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' ``` ## Response Parameters ### HTTP 200 Response Body: `application/json` Detailed extension information. | Attribute | Type | Description | |---|---|---| | installsource | string | Numeric install source code | | browser_type | string | Browser type as string | | img_file | string | Extension icon/logo filename | | description | string | Extension description | | extn_type | string | Extension source type | | shortname | string | Short identifier name | | version | string | Extension version string | | extensionname | string | Extension name | | homepageurl | string | Extension homepage URL | | crx_path | string | Path to the CRX extension package | | permissions | array | All permission names | | updateurl | string | Extension update check URL | | id | string | Webstore or internal extension ID | | extension_logo_id | string | Logo asset identifier | | allowed_permissions | array | Allowed permission names | #### Sample Response: Extension details ```json { "installsource": "1", "browser_type": "9", "img_file": "NormalState-48.png", "description": "Now everyone on the team can own quality. Capture findings, create issues, and collaborate with the team, directly from the browser.", "extn_type": "web_store", "shortname": "XT, exploratory tesing, feedback, TF", "version": "1.0.271.1", "extensionname": "Test Feedback", "homepageurl": "https://marketplace.visualstudio.com/items?itemName=ms.vss-exploratorytesting-web", "crx_path": "..\\webapps\\DesktopCentral\\bsp\\client-data\\1\\ManagedExtensions\\6", "permissions": [ "Active tab", "Clipboard read", "Tabs", "Storage", "Desktop capture", "Unlimited storage", "CPU metadata", "Memory metadata", "Display metadata", "Web navigation", "Background", "Tab capture", "Alarms" ], "updateurl": "https://clients2.google.com/service/update2/crx", "id": "gnldpbnocfnlkkicnaplmkaphfdnlplb", "extension_logo_id": "606", "allowed_permissions": [] } ``` #### Sample Response: Invalid extension ID ```json {} ``` ### HTTP 401 Response Body: `application/json` | Attribute | Type | Description | |---|---|---| | errorCode | long | Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required) | | errorMsg | string | Authentication failure reason | #### Sample Response: Unauthorized ```json { "errorCode": "UNAUTHORIZED", "errorMsg": "You are not authorized to perform this action" } ``` ### HTTP 403 Response Body: `application/json` | Attribute | Type | Description | |---|---|---| | errorCode | long | Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin) | | errorMsg | string | Message indicating insufficient privileges to access this resource | #### Sample Response: Forbidden ```json { "errorCode": "FORBIDDEN", "errorMsg": "You do not have permission to access this resource" } ``` ### HTTP 429 Response Body: `application/json` | Attribute | Type | Description | |---|---|---| | errorCode | long | Rate limit error code returned when the API call threshold (configured via threshold/duration in security XML) is exceeded; client is locked out for lock-period minutes | | errorMsg | string | Rate limit exceeded message with retry guidance | #### Sample Response: Rate limit exceeded ```json { "errorCode": "RATE_LIMIT_EXCEEDED", "errorMsg": "You have exceeded the maximum number of API calls. Please try again later." } ``` ### HTTP 500 Response Body: `application/json` Internal server error during extension operations. | Attribute | Type | Description | |---|---|---| | error_description | string | Error message describing the server failure | | error_code | string | Error code for internal server errors | #### Sample Response: Server error ```json { "error_description": "Internal Server error, Please try again in a moment.", "error_code": "COM0004" } ``` ## Rate Limits ![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png) **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.