Power BI Profiles API
The Profiles API from Power BI — 2 operation(s) for profiles.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/power-bi:power-bi-profiles-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Power Bi Profiles API
version: v1.0
description: 'Operations tagged Profiles across 2 of this provider''s published API definitions: power-bi-client-swagger.json, power-bi-client-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.powerbi.com
security: []
tags:
- name: Profiles
paths:
/v1.0/myorg/profiles:
get:
tags:
- Profiles
summary: Returns a list of service principal profiles
description: 'Returns a list of profiles that belongs to service principal caller.
## Limitations
Can only be called by a service principal.'
operationId: Profiles_GetProfiles
parameters:
- name: $top
in: query
description: Returns only the first n results
required: false
schema:
type: integer
format: int32
- name: $skip
in: query
description: Skips the first n results
required: false
schema:
type: integer
format: int32
- name: $filter
in: query
description: Get a profile by DisplayName
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ServicePrincipalProfiles'
x-ms-examples:
Get service principal profiles:
parameters: {}
responses:
'200':
body:
value:
- id: 3b211778-e7a5-4d73-8187-f10824047724
displayName: My new profile
Get a specific profile by displayName using filter:
parameters:
$filter: displayName%20eq%20'My%20new%20profile'
responses:
'200':
body:
value:
- id: 3b211778-e7a5-4d73-8187-f10824047724
displayName: My new profile
deprecated: false
post:
tags:
- Profiles
summary: Creates a new service principal profile
description: 'Creates a new profile that belongs to service principal caller.
## Limitations
Can only be called by a service principal. The maximum number of profiles a single service principal can have, is 100,000.'
operationId: Profiles_CreateProfile
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ServicePrincipalProfile'
x-ms-examples:
Create a service principal profile:
parameters:
CreateOrUpdateProfileRequest:
displayName: My new profile
responses:
'200':
body:
id: b2ded813-54b7-43f4-b072-ed4c1f9d5824
displayName: My new profile
deprecated: false
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateOrUpdateProfileRequest'
description: The create profile request
required: true
servers:
- url: https://api.powerbi.com
/v1.0/myorg/profiles/{profileId}:
get:
tags:
- Profiles
summary: Returns the specified service principal profile
description: 'Returns the specified profile if it exists and belongs to service principal caller.
## Limitations
Can only be called by a service principal.'
operationId: Profiles_GetProfile
parameters:
- name: profileId
in: path
description: The service principal profile ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ServicePrincipalProfile'
x-ms-examples:
Get service principal profile:
parameters:
profileId: b2ded813-54b7-43f4-b072-ed4c1f9d5824
responses:
'200':
body:
id: b2ded813-54b7-43f4-b072-ed4c1f9d5824
displayName: My new profile
deprecated: false
put:
tags:
- Profiles
summary: Updates the specified service principal profile name
description: 'Updates the specified profile name if it exists and belongs to service principal caller.
## Limitations
Can only be called by a service principal.'
operationId: Profiles_UpdateProfile
parameters:
- name: profileId
in: path
description: The service principal profile ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ServicePrincipalProfile'
x-ms-examples:
Updates a service principal profile:
parameters:
profileId: b3ded933-57b7-21f4-b072-ed4c1f9d5824
CreateOrUpdateProfileRequest:
displayName: My updated profile
responses:
'200':
body:
id: b3ded933-57b7-21f4-b072-ed4c1f9d5824
displayName: My updated profile
deprecated: false
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateOrUpdateProfileRequest'
description: The update profile request
required: true
delete:
tags:
- Profiles
summary: Deletes the specified service principal profile
description: 'Deletes the specified profile if it exists and belongs to service principal caller.
## Limitations
Can only be called by a service principal.'
operationId: Profiles_DeleteProfile
parameters:
- name: profileId
in: path
description: The service principal profile ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
x-ms-examples:
Delete a service principal profile:
parameters:
profileId: b3ded933-57b7-21f4-b072-ed4c1f9d5824
responses:
'200': {}
deprecated: false
servers:
- url: https://api.powerbi.com
components:
schemas:
CreateOrUpdateProfileRequest:
required:
- id
description: A Power BI service principal profile create or update request
properties:
displayName:
type: string
description: The service principal profile name
ServicePrincipalProfile:
required:
- id
description: A Power BI service principal profile. Only relevant for [Power BI Embedded multi-tenancy solution](/power-bi/developer/embedded/embed-multi-tenancy).
properties:
id:
type: string
format: uuid
description: The service principal profile ID
displayName:
type: string
description: The service principal profile name
ServicePrincipalProfiles:
description: Odata response wrapper for a Power BI service principal profile collection.
properties:
'@odata.context':
type: string
description: OData context
value:
type: array
description: The service principal profile collection
items:
$ref: '#/components/schemas/ServicePrincipalProfile'
x-refined-from:
- power-bi-client-swagger.json
- power-bi-client-openapi.json