# Microsoft Fabric Notebook REST APIs API > Microsoft Fabric Notebook REST APIs API on Apizie: 12 endpoints (Returns a list of notebooks from the specified workspace., Creates a notebook in the specified workspace., Returns properties of the specified notebook., Updates the properties of the specified notebook., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/analytics:microsoft-fabric-notebook/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `analytics:microsoft-fabric-notebook` - Category: Analytics - Status: byok - Source: https://learn.microsoft.com/rest/api/fabric/ - Page: https://apizie.tech/api/analytics/microsoft-fabric-notebook - OpenAPI: https://apizie.tech/api/analytics/microsoft-fabric-notebook/openapi.json ## Endpoints ### Returns a list of notebooks from the specified workspace. `GET https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-list-notebooks` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | recursive | boolean | no | Lists items in a folder and its nested folders, or just a folder only. True - All items in the folder and its nested folders are listed,… | | rootFolderId | string | no | This parameter allows users to filter items based on a specific root folder. If not provided, the workspace is used as the root folder. | | continuationToken | string | no | A token for retrieving the next page of results. | ### Creates a notebook in the specified workspace. `POST https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-create-notebook` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | body | object | yes | JSON request body | ### Returns properties of the specified notebook. `GET https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-get-notebook` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | notebookId | string | yes | The notebook ID. | ### Updates the properties of the specified notebook. `POST https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-update-notebook` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | notebookId | string | yes | The notebook ID. | | body | object | yes | JSON request body | ### Deletes the specified notebook. `POST https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-delete-notebook` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | notebookId | string | yes | The notebook ID. | | hardDelete | boolean | no | Specifies whether to perform a hard delete. When set to `true`, the item is permanently deleted and cannot be recovered. When set to… | ### Returns the specified notebook public definition. `POST https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-get-notebook-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | notebookId | string | yes | The notebook ID. | | format | string | no | The format of the notebook public definition. Supported format: `ipynb` and `fabricGitSource`. If no format is provided, `fabricGitSource`… | ### Overrides the definition for the specified notebook. `POST https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-update-notebook-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | notebookId | string | yes | The notebook ID. | | updateMetadata | boolean | no | When set to true and the .platform file is provided as part of the definition, the item's metadata is updated using the metadata in the… | | body | object | yes | JSON request body | ### Returns a list of livy sessions from the specified item identifier. `GET https://apizie.tech/v1/analytics:microsoft-fabric-notebook/livy-sessions-list-livy-sessions` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace identifier. | | notebookId | string | yes | The notebook ID. | | continuationToken | string | no | Token to retrieve the next page of results, if available. | ### Returns a list of livy sessions from the specified item identifier (beta). `GET https://apizie.tech/v1/analytics:microsoft-fabric-notebook/livy-sessions-list-livy-sessions-beta` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace identifier. | | notebookId | string | yes | The notebook ID. | | beta | boolean | yes | This required parameter must be set to `true` to access this API, which is currently in beta. | | submittedDateTime | string | no | Submitted date time filter. Filter the sessions based on the submitted date time in UTC, using the YYYY-MM-DDTHH:mm:ssZ format. | | endDateTime | string | no | Ended date time filter. Filter the sessions based on the ended date time in UTC, using the YYYY-MM-DDTHH:mm:ssZ format. | | submitter.Id | string | no | The GUID value of the user who submitted the session. | | state | string | no | The state of the session. Possible values are: `NotStarted`, `InProgress`, `Cancelled`, `Failed`, `Succeeded`, `Unknown`. This value maps… | | continuationToken | string | no | Token to retrieve the next page of results, if available. | ### Returns properties of the specified livy session. `GET https://apizie.tech/v1/analytics:microsoft-fabric-notebook/livy-sessions-get-livy-session` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace identifier. | | notebookId | string | yes | The notebook ID. | | livyId | string | yes | The session identifier. | ### Run on-demand notebook job instance. `POST https://apizie.tech/v1/analytics:microsoft-fabric-notebook/background-jobs-run-on-demand-notebook` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | notebookId | string | yes | The notebook item ID. | | beta | boolean | yes | This parameter specifies which version of the API to use. Set to `false` to use the release version. | | body | object | no | JSON request body | ### Get one notebook's job instance. `GET https://apizie.tech/v1/analytics:microsoft-fabric-notebook/background-jobs-get-notebook-job-instance-beta` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | notebookId | string | yes | The notebook ID. | | jobInstanceId | string | yes | The job instance ID. | | beta | boolean | yes | This required parameter must be set to `true` to access this API, which is currently in beta. | ## Example ``` curl "https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-list-notebooks" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Microsoft Fabric Notebook REST APIs API? Create a free Apizie key, then send GET https://apizie.tech/v1/analytics:microsoft-fabric-notebook/items-list-notebooks with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Microsoft Fabric Notebook REST APIs API free on Apizie? Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Microsoft Fabric Notebook REST APIs itself also needs your own key from fabric.microsoft.com. ### Can AI agents use the Microsoft Fabric Notebook REST APIs API? Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:microsoft-fabric-notebook. ### What is the status of the Microsoft Fabric Notebook REST APIs API? Needs your own provider key (bring your own key)