The Capacities API from Microsoft Fabric — 1 operation(s) for capacities.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/microsoft-fabric:microsoft-fabric-capacities-api"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.
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: 3.2.0
info:
title: Microsoft Fabric Capacities API
version: v1
x-refined-note:
- x-generated-by differs across the merged source definitions and was not carried
- x-generated-from differs across the merged source definitions and was not carried
- x-source differs across the merged source definitions and was not carried
description: 'Operations tagged Capacities across 2 of this provider''s published API definitions: microsoft-fabric-openapi.yml, microsoft-fabric-platform-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.fabric.microsoft.com/v1
description: Microsoft Fabric REST API
tags:
- name: Capacities
paths:
/capacities:
get:
tags:
- Capacities
summary: List capacities
operationId: listCapacities
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GenericList'
security:
- bearerAuth: []
servers:
- url: https://api.fabric.microsoft.com/v1
description: Microsoft Fabric REST API
/capacities/{capacityId}:
get:
summary: Returns specified capacity information
description: '## Permissions
The caller must have *administrator* or *contributor* permissions on the capacity.
## Required Delegated Scopes
Capacity.Read.All or Capacity.ReadWrite.All
## Microsoft Entra supported identities
This API supports the Microsoft identities listed in this section.
| Identity | Support |
|-|-|
| User | Yes |
| Service principal and Managed identities | Yes |
## Interface'
tags:
- Capacities
operationId: Capacities_GetCapacity
parameters:
- in: path
name: capacityId
description: The capacity ID.
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Request completed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/Capacity'
'429':
description: The service rate limit was exceeded. The server returns a `Retry-After` header indicating, in seconds, how long the client must wait before sending additional requests.
x-ms-error-response: true
headers:
Retry-After:
description: The number of seconds to wait before retrying the request.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
default:
description: 'Common error codes:
* UnknownError - An error occurred.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
servers:
- url: https://api.fabric.microsoft.com/v1
/capacities/{capacityId}/overageConfiguration:
get:
summary: Gets the overage configuration for the specified capacity
description: '> [!NOTE]
> Capacity overage configuration is currently in Preview.
## Permissions
The caller must have *admin* permissions on the capacity.
## Required Delegated Scopes
Capacity.Read.All or Capacity.ReadWrite.All
## Limitations
None.
## Microsoft Entra supported identities
This API supports the Microsoft identities listed in this section.
| Identity | Support |
|-|-|
| User | Yes |
| Service principal and Managed identities | Yes |
## Interface'
tags:
- Capacities
operationId: Capacities_GetOverageConfiguration
parameters:
- in: path
name: capacityId
description: The capacity ID.
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Request completed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/CapacityOverageConfiguration'
'429':
description: The service rate limit was exceeded. The server returns a `Retry-After` header indicating, in seconds, how long the client must wait before sending additional requests.
x-ms-error-response: true
headers:
Retry-After:
description: The number of seconds to wait before retrying the request.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
default:
description: 'Common error codes:
* CapacityNotFound - The specified capacity was not found.
* Unauthorized - The caller doesn''t have permission to call the API.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
patch:
summary: Updates the overage configuration for the specified capacity
description: '> [!NOTE]
> Capacity overage configuration is currently in Preview.
## Permissions
The caller must have *admin* permissions on the capacity.
## Required Delegated Scopes
Capacity.ReadWrite.All
## Limitations
None.
## Microsoft Entra supported identities
This API supports the Microsoft identities listed in this section.
| Identity | Support |
|-|-|
| User | Yes |
| Service principal and Managed identities | Yes |
## Interface'
tags:
- Capacities
operationId: Capacities_UpdateOverageConfiguration
parameters:
- in: path
name: capacityId
description: The capacity ID.
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Request completed successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/CapacityOverageConfiguration'
'429':
description: The service rate limit was exceeded. The server returns a `Retry-After` header indicating, in seconds, how long the client must wait before sending additional requests.
x-ms-error-response: true
headers:
Retry-After:
description: The number of seconds to wait before retrying the request.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
default:
description: 'Common error codes:
* CapacityNotFound - The specified capacity was not found.
* Unauthorized - The caller doesn''t have permission to call the API.
* InvalidRequest - The request payload is invalid.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateCapacityOverageConfigurationRequest'
description: The update overage configuration request payload.
required: true
servers:
- url: https://api.fabric.microsoft.com/v1
components:
schemas:
GenericObject:
type: object
additionalProperties: true
GenericList:
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/GenericObject'
additionalProperties: true
UpdateCapacityOverageConfigurationRequest:
description: The overage configuration update request payload. At least one property must be provided. When `state` is set to `Disabled`, `thresholdCapacityUnitHours` is automatically reset to 0. When `state` is set to `Enabled`, a `thresholdCapacityUnitHours` greater than 0 must be supplied (either in the same request or already configured). Setting `thresholdCapacityUnitHours` to 0 automatically disables overage.
type: object
minProperties: 1
properties:
state:
$ref: '#/components/schemas/CapacityOverageState'
thresholdCapacityUnitHours:
description: The capacity unit hours threshold for overage. Valid range is 0 to 240000. Setting to 0 automatically disables overage.
type: integer
format: int32
minimum: 0
maximum: 240000
readOnly: false
ErrorResponse:
description: The error response.
required:
- message
- errorCode
allOf:
- $ref: '#/components/schemas/ErrorResponseDetails'
properties:
requestId:
type: string
format: uuid
description: ID of the request associated with the error.
readOnly: true
moreDetails:
description: List of additional error details.
type: array
items:
$ref: '#/components/schemas/ErrorResponseDetails'
readOnly: true
isRetriable:
type: boolean
description: When true, the request can be retried. Use the `Retry-After` response header to determine the delay, if available.
readOnly: true
CapacityOverageConfiguration:
description: The overage configuration for a capacity.
type: object
required:
- state
- thresholdCapacityUnitHours
properties:
state:
$ref: '#/components/schemas/CapacityOverageState'
thresholdCapacityUnitHours:
description: The capacity unit hours threshold for overage. Valid range is 0 to 240000.
type: integer
format: int32
minimum: 0
maximum: 240000
readOnly: true
ErrorParameter:
description: A structured parameter providing additional machine-readable context about an error.
type: object
properties:
name:
type: string
description: The parameter identifier.
readOnly: true
value:
type: string
description: The parameter value.
readOnly: true
message:
type: string
description: A human-readable description of the parameter's meaning.
readOnly: true
CapacityOverageState:
description: The state of overage. Additional overage states may be added over time.
type: string
enum:
- Disabled
- Enabled
x-ms-enum:
name: CapacityOverageState
modelAsString: true
values:
- value: Disabled
description: Overage is disabled for the capacity.
- value: Enabled
description: Overage is enabled for the capacity.
Capacity:
description: A capacity object.
type: object
required:
- id
- displayName
- sku
- region
- state
properties:
id:
description: The capacity ID.
type: string
format: uuid
readOnly: true
displayName:
description: The capacity display name.
type: string
readOnly: true
sku:
description: The capacity SKU.
type: string
readOnly: true
region:
description: The Azure region where the capacity was provisioned.
type: string
readOnly: true
state:
$ref: '#/components/schemas/CapacityState'
ErrorResponseDetails:
description: The error response details.
type: object
required:
- message
- errorCode
properties:
errorCode:
type: string
description: A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users.
readOnly: true
message:
type: string
description: A human readable representation of the error.
readOnly: true
relatedResource:
$ref: '#/components/schemas/ErrorRelatedResource'
parameters:
description: Structured parameters providing additional machine-readable context about the error.
type: array
items:
$ref: '#/components/schemas/ErrorParameter'
readOnly: true
ErrorRelatedResource:
description: The error related resource details object.
type: object
required:
- resourceId
- resourceType
properties:
resourceId:
type: string
description: The resource ID that's involved in the error.
readOnly: true
resourceType:
type: string
description: The type of the resource that's involved in the error.
readOnly: true
PaginatedResponse:
properties:
continuationToken:
type: string
description: The token for the next result set batch. If there are no more records, it's removed from the response.
continuationUri:
type: string
description: The URI of the next result set batch. If there are no more records, it's removed from the response.
CapacityState:
type: string
description: A Capacity state. Additional capacity states may be added over time.
enum:
- Active
- Inactive
x-ms-enum:
name: CapacityState
modelAsString: true
values:
- value: Active
description: The capacity is ready to use.
- value: Inactive
description: The capacity can't be used.
Capacities:
required:
- value
type: object
properties:
value:
description: A list of capacities.
type: array
items:
$ref: '#/components/schemas/Capacity'
allOf:
- $ref: '#/components/schemas/PaginatedResponse'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
x-refined-from:
- microsoft-fabric-openapi.yml
- microsoft-fabric-platform-openapi.yml