> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Microsoft Fabric for Langdock

> Prepare a Fabric API for GraphQL and configure the Langdock integration as a Fabric owner or workspace admin.

Use this guide if you are a Fabric workspace admin, owner of the API for GraphQL, or Langdock workspace admin. After you complete the configuration, individual users only need to add their connection. For access and write operation decisions, see [Access and mutations](./permissions-and-mutations).

## Before you start

You need:

* A Fabric workspace backed by a Fabric, Trial, or Premium capacity.

## Set up the API for GraphQL in Fabric

As a Fabric workspace admin or API owner, prepare the API for Langdock:

<Steps>
  <Step title="Create an API for GraphQL">
    In the Fabric workspace, create an **API for GraphQL** item.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/CfHAj9rI4w7rWDXP/images/integrations/microsoft-fabric/create-api.png?fit=max&auto=format&n=CfHAj9rI4w7rWDXP&q=85&s=15097e4ad182d449306ed91fa7169f8c" alt="API for GraphQL in the Microsoft Fabric New item panel" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="images/integrations/microsoft-fabric/create-api.png" />
    </Frame>
  </Step>

  <Step title="Choose how the API connects to its data sources">
    Choose **Single sign-on (SSO)** (recommended) when users should access the source with their own identity. Choose **Saved credentials** when every API caller should use one centrally managed source identity. Each GraphQL API uses a single mode across its sources.

    If you are unsure which option fits, [compare how each authentication model handles identity, permissions, and access](./permissions-and-mutations#choose-how-fabric-accesses-data).

    <Frame>
      <img src="https://mintcdn.com/langdock-34/CfHAj9rI4w7rWDXP/images/integrations/microsoft-fabric/connectivity-option.png?fit=max&auto=format&n=CfHAj9rI4w7rWDXP&q=85&s=7b17b2a8832fd973c089588666ef912f" alt="Microsoft Fabric connectivity dialog with single sign-on selected" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="images/integrations/microsoft-fabric/connectivity-option.png" />
    </Frame>
  </Step>

  <Step title="Choose the data to expose">
    Add the relevant data sources and select the tables, views, stored procedures, and columns to include. Define relationships between objects in the same source when users should retrieve related records in one query. Relationships are available between objects from the same source.

    Keep the schema focused on the intended use case by including only the objects and operations consumers need.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/CfHAj9rI4w7rWDXP/images/integrations/microsoft-fabric/choose-data.png?fit=max&auto=format&n=CfHAj9rI4w7rWDXP&q=85&s=ecf276aaa8014997ec5cfa38f492a9e2" alt="Selected tables, view, and stored procedure in the Microsoft Fabric Choose data dialog" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="images/integrations/microsoft-fabric/choose-data.png" />
    </Frame>
  </Step>

  <Step title="Enable introspection">
    Open **API Settings**, select **Introspection**, and enable it. Introspection is disabled by default. Enabling it allows Langdock to discover the available types, fields, arguments, queries, and mutations, and makes this schema metadata visible to all users with access to the API endpoint.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/oDPnwHvhtQtGyLBC/images/integrations/microsoft-fabric/introspection.png?fit=max&auto=format&n=oDPnwHvhtQtGyLBC&q=85&s=2a22ddbd39b5b54277bfe01d89fcc78c" alt="Introspection enabled in the settings for a Microsoft Fabric API for GraphQL" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="images/integrations/microsoft-fabric/introspection.png" />
    </Frame>
  </Step>

  <Step title="Grant access">
    Give every user **Run Queries and Mutations** on the GraphQL API item. The grant dialog uses that label, while **Direct access** and its ellipsis menu summarize and manage the same permission as **Execute**.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/CfHAj9rI4w7rWDXP/images/integrations/microsoft-fabric/api-permission.png?fit=max&auto=format&n=CfHAj9rI4w7rWDXP&q=85&s=f05bb7958c1bd2f2c87348cb3b66bf47" alt="Selected Run Queries and Mutations permission in the Microsoft Fabric API for GraphQL grant dialog" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="images/integrations/microsoft-fabric/api-permission.png" />
    </Frame>

    With SSO, also grant each user the required permissions on every underlying source. With Saved credentials, grant the saved Fabric identity the required source permissions instead. See [Control who can read or change data](./permissions-and-mutations#control-who-can-read-or-change-data).
  </Step>

  <Step title="Refresh and verify the schema">
    After adding, removing, or changing source objects, select **Update schema** and verify the result in **Schema explorer** so the API reflects the latest source schema.

    Run a focused query in Fabric and confirm that the expected source objects and results are available before connecting users.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/oDPnwHvhtQtGyLBC/images/integrations/microsoft-fabric/graphql-query.png?fit=max&auto=format&n=oDPnwHvhtQtGyLBC&q=85&s=dfa73ac5152be4d5a849bd07e5164d57" alt="Microsoft Fabric GraphQL editor with a regional sales query and successful results" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="images/integrations/microsoft-fabric/graphql-query.png" />
    </Frame>
  </Step>
</Steps>

## Enable the integration in Langdock

As a Langdock workspace admin, enable Microsoft Fabric. Langdock can then find APIs, inspect their schemas, query data, and use mutations without requiring users to provide IDs or endpoint URLs. The mutation action asks for confirmation before execution.

<Frame>
  <img src="https://mintcdn.com/langdock-34/CfHAj9rI4w7rWDXP/images/integrations/microsoft-fabric/action-access.png?fit=max&auto=format&n=CfHAj9rI4w7rWDXP&q=85&s=faad1f530c287aa5cff5593c3ff7cedc" alt="Microsoft Fabric read and mutation actions enabled separately in Langdock workspace settings" style={{borderRadius: '6px'}} width="2240" height="1244" data-path="images/integrations/microsoft-fabric/action-access.png" />
</Frame>

If newly enabled actions add Microsoft permissions, ask existing users to reconnect once.

## Connect users

Ask each user to open Microsoft Fabric in Langdock, select **Add connection**, and sign in with the Microsoft account you granted access to.

Direct users to the [three step user guide](../microsoft-fabric#use-microsoft-fabric). If an API is not discoverable by name, see [Troubleshooting](./troubleshooting).

## Validate the setup

Use a representative business user to confirm the access you intend to roll out:

1. Run a focused query in Fabric's GraphQL editor as that user.
2. In Langdock, ask a question that requires the same data and compare the result with the source.
3. If you expose mutations, use a disposable record, confirm the operation in Langdock, and verify the change in Fabric.

If a check fails, use [Troubleshooting](./troubleshooting) to identify whether discovery, schema, or permissions need attention.
