Extension

The Extension object represents a set of requirements (parameters) that vendors ask their clients to meet. Think of it as a checklist (extension parameters) that ensures clients are ready and able to work with the vendor’s products or services.

Field	Type	Description
id	string, core	(Read-only) The identifier for the extension.
name	string, core	The name of the extension.
website	URI	(Optional) URL for the extension website.
icon	string, core	The logo of the extension.
shortDescription	string	(Optional) A short description of the extension.
longDescription	string	(Optional) A long description of the extension.
categories	object	Represents the category object, which contains a list of selected categories.
vendor	object	Represents the vendor account object.
status	enum	The status of the extension. Allowed values are: Draft Deleted - Can be deleted if it's in a draft state. Public - Available in the extensions directory. Only an Operations user can make the extension public. Private - Not available in the extensions directory, but can be accessed through an invitation.
statistics	object	(Read-only) Represents the extensionStatistics object.
configuration	object	Represents the configuration object. Available only if retrieved with the extension’s token or vendor token.
service	object	Represents the service object.
meta	object	(Read-only) (Optional) Represents the extensionMeta object.
audit	object	Represents the audit object.

Extension Statistics object

Field	Type	Description
installations	integer	(Read-only) Number of installations assigned to the extension.

Service object

Field	Type	Description
secret	string	Represents the secret key.

Example

EXTENSION OBJECT

{
  "id": "EXT-1234-5678",
  "name": "Microsoft AI Cloud Partner extension",
  "website": "https://www.microsoft.com",
  "icon": "/v1/extension/extensions/EXT-1234-1234/icon",
  "shortDescription": "Microsoft 365 and Office 365 extension",
  "longDescription": "Microsoft 365 and Office 365 are cloud-based productivity suites that offer a range of applications and services to help businesses of all sizes work more efficiently.",
   "categories": [
      { 
          "id": "EXC-1111-1111", 
          "name": "Accounting & finance"
      } 
  ],
  "vendor": {
      "id": "ACC-1234-1234"
  },
  "status": "Private",
  "statistics": {
    "installations": 100
  },
  "service": {
    "secret": "ds340ffdjBfdj9834hfin4g"
  }
  "configuration": {
    "prop1": "value"
  },
  "meta": {
    "id": "EXM-1234-1234"
  }
}