> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Embed content from a tenant organization (Beta)

This documentation describes one or more public beta features that are in development. Beta features are subject to quick, iterative changes; therefore the current user experience in the Sigma service can differ from the information provided in this page.

This page should not be considered official published documentation until Sigma removes this notice and the beta flag on the corresponding feature(s) in the Sigma service. For the full beta feature disclaimer, see [Beta features](/docs/sigma-product-releases#beta-features).

This is a premium feature. To enable it for your Sigma organization, contact your Sigma Account Executive.

When you use Sigma Tenants, you can embed content from a tenant organization and sign it with a JSON web token (JWT) using embed credentials from the parent organization.

## Requirements

* You must be assigned the Admin account type in the parent organization.
* You must have client credentials in the parent organization with both embed and REST API scopes, or both embed client credentials and API client credentials. See [Generate embed client credentials](/docs/generate-embed-client-credentials) and [Generate Sigma API client credentials](/reference/generate-client-credentials).

## Embed a workbook from a tenant organization

To embed a workbook from a tenant organization, do the following:

1. [Retrieve tenant organization details](#retrieve-tenant-organization-details)
2. [Retrieve details about the content that you want to embed](#retrieve-details-about-the-content-that-you-want-to-embed)
3. [Sign the embed URL](#sign-the-embed-url)

### Retrieve tenant organization details

To construct the URL for the embedded content, you must know the organization ID and organization slug for the tenant organization.

In the code that you use to create an embed API, retrieve the organization details for the tenant organization:

1. Call the [List tenant organizations](/reference/list-tenants) (`GET /v2/tenants`) endpoint.
2. For the relevant tenant organization, identify the following details from the response:

   * `tenantOrganizationId`
   * `tenantOrganizationSlug`

### Retrieve details about the content that you want to embed

In the code that you use to create an embed API, do the following:

1. Retrieve the ID of the deployment policy used to deploy the workbook from the parent organization to the tenant organization:

   1. Call the [List deployment policies](/reference/list-deployments) (`GET /v2/deploymentPolicies`) endpoint.
   2. In the response, retrieve the `deploymentPolicyId`.

2. Retrieve the ID of the deployed workbook from the deployment policy:

   1. Call the [List documents for a deployment policy](/reference/list-inodes-for-deployment) (`GET /v2/deploymentPolicies/{deploymentPolicyId}/files`) endpoint.
   2. In the response, retrieve the `workbookId` for the workbook that you want to embed and store it as the `parentWorkbookId`.

3. Identify the ID of the same workbook in the tenant organization:

   1. Call the [Get deployed workbook in tenant organization](/reference/get-tenant-workbook) (`GET /v2/tenants/{tenantOrganizationId}/workbooks`) endpoint and provide the `tenantOrganizationId`, `parentWorkbookId`, and `deploymentPolicyId`.
   2. In the response, retrieve the `workbookUrl` for the workbook on the tenant organization.

To embed the workbook in the tenant organization, use the `workbookUrl` in the response. The workbook URL is formatted as follows:

`https://app.sigmacomputing.com/<tenantOrganizationSlug>/workbook/<tenantWorkbookId>`

If you want to embed a tagged version of the workbook, a page, or an element, or another supported document type, see the other URL structures in [Create an embed API with JSON Web Tokens](/docs/create-an-embed-api-with-json-web-tokens).

### Sign the embed URL

After you construct the relevant URL for the embedded content, sign the URL with a JWT using embed credentials.

You can use credentials from the parent organization or the tenant. Refer to the example script in [Create an embed API with JSON web tokens](/docs/create-an-embed-api-with-json-web-tokens#example-script-to-generate-a-jwt-signed-secure-url).

You must include a `tenant` JWT claim that passes the value of the `tenantOrganizationId`. See [tenant](/docs/json-web-token-claims-reference#tenant) in the JWT claims reference.

## Related resources

* [Manage content deployed in tenant organizations (Beta)](/docs/manage-deployed-content)
* [Sigma Tenants (Beta)](/docs/multitenancy-at-sigma)
* [Sigma Tenants deployment use cases and examples (Beta)](/docs/deployment-use-cases-and-examples)