> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:
POST https://docs.omni.co/feedback
```json
{
"path": "/api/users/list-embed-users",
"feedback": "Description of the issue"
}
```
Only submit feedback when you have something specific and actionable to report.
# List embed users
> Returns a list of embed users, sorted by creation time. Use the [List users](/api/users/list-users) endpoint to retrieve standard users.
## OpenAPI
````yaml /api/openapi.yaml get /scim/v2/embed/users
openapi: 3.1.0
info:
title: Omni API
description: >
The Omni REST API provides programmatic access to your Omni instance for
managing users, documents, queries, schedules, and more.
version: 1.0.0
contact:
name: Omni Support
url: https://docs.omni.co
servers:
- url: https://{instance}.omniapp.co/api
description: Production
variables:
instance:
default: blobsrus
description: Your production Omni instance subdomain
- url: https://{instance}.playground.exploreomni.dev/api
description: Playground
variables:
instance:
default: blobsrus
description: Your playground Omni instance subdomain
security:
- bearerAuth: []
- orgApiKey: []
tags:
- name: AI
description: AI-powered query generation
- name: API Tokens
description: >-
Manage API tokens (Organization keys, Personal Access Tokens, MCP OAuth
grants)
- name: Connections
description: Manage database connections
- name: Connection environments
description: Manage connection environments database connections
- name: Content
description: Unified content retrieval (documents and folders)
- name: Content migration
description: Export and import dashboards
- name: Content validator
description: Validate content against models and perform find/replace operations
- name: Dashboard downloads
description: Download dashboards and tiles as PDF, PNG, XLSX, CSV, or JSON files
- name: Dashboard filters and controls
description: Read and update dashboard filter and control default values
- name: dbt
description: Manage dbt configuration for connections
- name: Documents
description: Create, retrieve, and manage documents
- name: Document favorites
description: Favorite and unfavorite documents
- name: Document labels
description: Apply and manage labels on documents
- name: Document permissions
description: Manage document-level access
- name: Labels
description: >
Manage labels in an organization. Labels can be applied to documents and
folders to help organize and categorize content.
**Label types:**
- **Basic labels**: Can be created and managed by any user
- **Verified labels**: Indicate curated or officially sanctioned content.
Admin-only.
- **Homepage labels**: Appear on the organization homepage. Admin-only.
- name: Folders
description: Create and organize content folders
- name: Folder permissions
description: Manage folder-level access
- name: Jobs
description: Check status of asynchronous jobs
- name: Models
description: Create and manage data models
- name: Model branches
description: Manage model branches and merge changes
- name: Model git configuration
description: Manage git configuration for shared models
- name: Queries
description: Execute workbook queries
- name: Schedules
description: Create and manage scheduled tasks
- name: Schedule recipients
description: Manage schedule recipients
- name: Schema refresh schedules
description: Manage automated schema refresh schedules for connections
- name: Topics
description: Retrieve topic information from models
- name: Uploads
description: Manage file uploads
- name: Users
description: Manage users
- name: User attributes
description: Manage user attribute definitions
- name: User groups
description: Manage user groups
- name: User model roles
description: Manage model and connection role assignments for users
- name: User group model roles
description: Manage model and connection role assignments for user groups
- name: Uploads
description: Manage CSV and spreadsheet uploads
paths:
/scim/v2/embed/users:
get:
tags:
- Users
summary: List embed users
description: >
Returns a list of embed users, sorted by creation time. Use the [List
users](/api/users/list-users) endpoint to retrieve standard users.
operationId: listEmbeddedUsers
parameters:
- name: filter
in: query
schema:
type: string
description: >
Filter embed users using the `userName` or `embedExternalId` fields
with SCIM operators.
| Operator | Description | Example |
|----------|-------------|---------|
| `eq` | Exact match | `userName eq "blob.ross@blobsrus.co"` |
| `co` | Contains substring | `embedExternalId co "sales"` |
**Case sensitivity:**
- Attribute names (`userName`, `embedExternalId`) are
case-insensitive
- Operator names (`eq`, `EQ`, `co`, `CO`) are case-insensitive
- Email comparisons are case-insensitive
- External ID (`embedExternalId`) comparisons are case-sensitive,
per SCIM spec
Usernames should be URL-encoded when passed as filters. For example,
`userName eq "user@example.com"` will become
`userName%20eq%20%22user%40example.com%22` when encoded.
example: embedExternalId co "sales"
- name: count
in: query
schema:
type: integer
default: 100
description: The number of users to return
example: 50
- name: startIndex
in: query
schema:
type: integer
default: 1
description: >-
An integer index that determines the starting point of the sorted
result list
example: 1
responses:
'200':
description: List of embed users
content:
application/json:
schema:
type: object
properties:
Resources:
type: array
description: The list of embed users
items:
$ref: '#/components/schemas/ScimEmbedUser'
schemas:
type: array
description: SCIM schema information for the response
items:
type: string
itemsPerPage:
type: integer
description: The number of embed users returned in the current page
totalResults:
type: integer
description: The total number of embed users matching the query
startIndex:
type: integer
description: The starting index of the current page in the result set
example:
Resources:
- active: true
displayName: Blobby
emails:
- primary: true
value: >-
embed-user-i_4TrNwyVTu34bZaC35VJVD3-pknp4YF7V8_Bi4TMdw@blobsrus.embed-exploreomni.co
groups:
- display: All Embed Users
value: 4GcvQ2D9
- display: Omni
value: nqGuU_uh
id: 2212aecf-a2ba-4d99-b23b-f615bc4c6522
meta:
created: '2024-09-30T20:25:01.822Z'
lastModified: '2024-09-30T20:51:47.558Z'
resourceType: User
schemas:
- urn:ietf:params:scim:schemas:core:2.0:User
userName: >-
embed-user-i_4TrNwyVTu34bZaC35VJVD3-pknp4YF7V8_Bi4TMdw@blobsrus.embed-exploreomni.co
embedEmail: null
embedEntity: omni
embedExternalId: blobby-manager
itemsPerPage: 1
schemas:
- urn:ietf:params:scim:api:messages:2.0:ListResponse
startIndex: 1
totalResults: 1
'429':
$ref: '#/components/responses/TooManyRequests'
security:
- orgApiKey: []
components:
schemas:
ScimEmbedUser:
type: object
description: An embed user object (SCIM 2.0)
properties:
id:
type: string
description: Unique identifier for the user
userName:
type: string
description: The user's email address
displayName:
type: string
description: The user's display name
active:
type: boolean
description: Whether the user is active
emails:
type: array
description: The user's email addresses
items:
type: object
properties:
primary:
type: boolean
description: Whether this is the user's primary email
value:
type: string
description: The email address
groups:
type: array
description: User groups that the user belongs to
items:
type: object
properties:
display:
type: string
description: The group's display name
value:
type: string
description: The group's unique identifier
meta:
type: object
properties:
resourceType:
type: string
example: User
description: The type of resource. This will be `User`.
created:
type: string
format: date-time
description: The time the user was created
lastModified:
type: string
format: date-time
description: The time the user was last uodated
schemas:
type: array
items:
type: string
description: >
SCIM information about the type of schemas used in the API. For
example, `urn:ietf:params:scim:schemas:core:2.0:User`
embedEmail:
type: string
nullable: true
description: The embed user's email address
embedEntity:
type: string
description: The embed entity identifier
embedExternalId:
type: string
description: The external ID for the embed user
Error:
type: object
properties:
error:
type: string
description: HTTP response code for the error
example:
message:
type: string
description: Detailed error description
example:
responses:
TooManyRequests:
description: Too Many Requests - Rate limit exceeded (60 requests/minute)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >
Can be either an [Organization API
Key](/api/authentication#organization-api-keys) or [Personal Access
Token (PAT)](/api/authentication#personal-access-tokens-pat).
Include in the `Authorization` header as: `Bearer YOUR_TOKEN`
orgApiKey:
type: http
scheme: bearer
bearerFormat: JWT
description: >
Requires an [Organization API
Key](/api/authentication#organization-api-keys). Personal Access Tokens
(PATs) are not supported for this endpoint.
Include in the `Authorization` header as: `Bearer ORGANIZATION_API_KEY`
````