> 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

> Embed content from a Sigma tenant organization and sign it with a JWT using parent or tenant organization embed credentials.

> **Note**
>
> 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 documents deployed to a tenant organization and sign the JSON web token (JWT) using embed credentials from either the parent organization or the tenant organization.

> **Info**
>
> If you want to embed a document created in a tenant organization, you must sign the JWT using embed credentials from the tenant organization. See [Create an embed API with JSON Web Tokens](/docs/create-an-embed-api-with-json-web-tokens).

## Requirements

* You must be assigned the Admin account type in the parent organization.
* You must have API client credentials with REST API scope in the parent organization to make the API calls in this workflow. See [Generate Sigma API client credentials](/reference/generate-client-credentials).
* You must have embed client credentials to sign the JWT. You can use embed credentials from either the parent organization or the tenant organization. See [Generate embed client credentials](/docs/generate-embed-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>`

> **Tip**
>
> 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.

You can use embed credentials from either the parent organization or the tenant organization. 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](/docs/manage-deployed-content)
* [Sigma Tenants](/docs/multitenancy-at-sigma)
* [Sigma Tenants deployment use cases and examples](/docs/deployment-use-cases-and-examples)