# Microsoft Fabric SparkJobDefinition REST APIs API > Microsoft Fabric SparkJobDefinition REST APIs API on Apizie: 11 endpoints (Returns a list of spark job definitions from the specified workspace., Creates a spark job definition in the specified workspace., Returns properties of the specified spark job definition., Updates the properties of the specified spark job definition., …) 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-sparkjobdefinition/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `analytics:microsoft-fabric-sparkjobdefinition` - Category: Analytics - Status: byok - Source: https://learn.microsoft.com/rest/api/fabric/ - Page: https://apizie.tech/api/analytics/microsoft-fabric-sparkjobdefinition - OpenAPI: https://apizie.tech/api/analytics/microsoft-fabric-sparkjobdefinition/openapi.json ## Endpoints ### Returns a list of spark job definitions from the specified workspace. `GET https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-list-spark-job-definitions` (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 spark job definition in the specified workspace. `POST https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-create-spark-job-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | body | object | yes | JSON request body | ### Returns properties of the specified spark job definition. `GET https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-get-spark-job-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | sparkJobDefinitionId | string | yes | The spark job definition ID. | ### Updates the properties of the specified spark job definition. `POST https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-update-spark-job-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | sparkJobDefinitionId | string | yes | The spark job definition ID. | | body | object | yes | JSON request body | ### Deletes the specified spark job definition. `POST https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-delete-spark-job-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | sparkJobDefinitionId | string | yes | The spark job definition 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 spark job definition public definition. `POST https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-get-spark-job-definition-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | sparkJobDefinitionId | string | yes | The spark job definition ID. | | format | string | no | The format of the request. Can be either `SparkJobDefinitionV1` or `SparkJobDefinitionV2`. Additional Format types may be added over time. | ### Overrides the definition for the specified spark job definition. `POST https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-update-spark-job-definition-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | sparkJobDefinitionId | string | yes | The spark job definition 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 | ### Run on-demand [Spark job definition](/fabric/data-engineering/run-spark-job-definition) job instance. `POST https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/background-jobs-run-on-demand-spark-job-definition` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace ID. | | sparkJobDefinitionId | string | yes | The Spark job definition item ID. | | body | object | no | JSON request body | ### Returns a list of livy sessions from the specified item identifier. `GET https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/livy-sessions-list-livy-sessions` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace identifier. | | sparkJobDefinitionId | string | yes | The sparkJobDefinition 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-sparkjobdefinition/livy-sessions-list-livy-sessions-beta` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace identifier. | | sparkJobDefinitionId | string | yes | The sparkJobDefinition 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-sparkjobdefinition/livy-sessions-get-livy-session` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | workspaceId | string | yes | The workspace identifier. | | sparkJobDefinitionId | string | yes | The sparkJobDefinition ID. | | livyId | string | yes | The session identifier. | ## Example ``` curl "https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-list-spark-job-definitions" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Microsoft Fabric SparkJobDefinition REST APIs API? Create a free Apizie key, then send GET https://apizie.tech/v1/analytics:microsoft-fabric-sparkjobdefinition/items-list-spark-job-definitions with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Microsoft Fabric SparkJobDefinition 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 SparkJobDefinition REST APIs itself also needs your own key from fabric.microsoft.com. ### Can AI agents use the Microsoft Fabric SparkJobDefinition 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-sparkjobdefinition. ### What is the status of the Microsoft Fabric SparkJobDefinition REST APIs API? Needs your own provider key (bring your own key)