---
title: "GetEmbedUser returns an embed user, which is created when GetIFrame is called with an external user ID. It is used to show which external user owns a report created from an embed."
method: GET
path: "/v1/orgs/{org}/projects/{project}/embed-users/{id}"
---

# GetEmbedUser returns an embed user, which is created when GetIFrame is called with an external user ID. It is used to show which external user owns a report created from an embed.

`GET /v1/orgs/{org}/projects/{project}/embed-users/{id}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/rilldata/apis/rill-admin-api/docs/v1/orgs/:org/projects/:project/embed-users/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org` string, required
- `project` string, required
- `id` string, required

## Response `200`

A successful response.

- V1GetEmbedUserResponse
  - `externalUserId` string: The external user ID passed to GetIFrame.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-02** (v1) `7532f8ec6bcd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/projects/:project/embed-users/:id/get.md)

---

[API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) - [All operations](https://skmtc.dev/rilldata/apis/rill-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rilldata/apis/rill-admin-api/revisions/5dfad67cc1ca?raw)