Available Features - Get Available Feature By Name

Returns the specified available feature for the user by name.

This API call doesn't require any scopes.

Permissions

This API call can be called by a service principal profile. For more information see: Service principal profiles in Power BI Embedded.

GET https://api.powerbi.com/v1.0/myorg/availableFeatures(featureName='{featureName}')

Name	In	Required	Type	Description
featureName	path	True	string	The feature name

Name	Type	Description
200 OK	AvailableFeature	OK

GET https://api.powerbi.com/v1.0/myorg/availableFeatures(featureName='embedTrial')

{
  "name": "embedTrial",
  "state": "Enabled",
  "extendedState": "Enabled",
  "additionalInfo": {
    "usage": 65
  }
}

Name	Description
AdditionalFeatureInfo	Additional feature information
AvailableFeature	A Power BI available feature
FeatureExtendedState	The feature extended state
FeatureState	The feature state

Additional feature information

Name	Type	Description
Usage	integer	Workspaces that aren't assigned to a capacity get a limited amount of embed tokens, to allow experimenting with the APIs. The `Usage` value represents the percentage of embed tokens that have been consumed. The `Usage` value only applies to the embed trial feature. For more information, see Development testing.

A Power BI available feature

Name	Type	Description
additionalInfo	AdditionalFeatureInfo	Additional feature information
extendedState	FeatureExtendedState	The feature extended state
name	string	The feature name
state	FeatureState	The feature state

The feature extended state

The feature state

Name	Type	Description
Disabled	string
Enabled	string