---
title: "List Realtime Conversation Groups"
method: GET
path: "/v1/convai/realtime/conversation-groups"
tags: ["Realtime"]
---

# List Realtime Conversation Groups

`GET /v1/convai/realtime/conversation-groups`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/realtime/conversation-groups`
- Auth: none declared

List the realtime conversation groups the current user can view.

## Query parameters

- `page_size` integer: How many conversation groups to return. Can not exceed 100.
- `search` string, nullable: If specified, only conversation groups whose title or description contains this string (case-insensitive) are returned.
- `cursor` string, nullable: Used for fetching next page. Cursor is returned in the response.

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- RealtimeConversationGroupsResponseModel
  - `conversation_groups` RealtimeConversationGroupResponseModel[], required
    - `id` string, required
    - `title` string, required
    - `description` string, nullable, required
    - `access_info` ResourceAccessInfo, required
      - `is_creator` boolean, required: Whether the user making the request is the creator of the agent
      - `creator_name` string, required: Name of the agent's creator
      - `creator_email` string, required: Email of the agent's creator
      - `role` 'admin' | 'editor' | 'commenter' | 'viewer', required: The role of the user making the request
      - `anonymous_access_level_override` 'admin' | 'editor' | 'commenter' | 'viewer', nullable: The access level for anonymous users. If None, the resource is not shared publicly.
      - `access_source` 'creator' | 'explicit' | 'workspace_admin' | 'workspace_default', nullable: Why the requesting user has access to this resource. 'creator' = caller is the owner. 'explicit' = caller (or one of their workspace groups) is listed in role_to_group_ids beyond the workspace-wide everyone group. 'workspace_default' = the workspace-wide everyone group is listed in role_to_group_ids (every non-anon workspace member, including admins, sees this resource). 'workspace_admin' = caller is a workspace admin and the admin seat is the *only* path to access; reserved for docs nobody else can see. Lets the UI disclose why an admin-bypass viewer sees a doc that wasn't explicitly shared with them.
    - `sharing` RealtimeConversationGroupSharingSummary, required: How widely a group is shared, besides its owner and workspace admins (who always have access).
      - `people_count` integer, required: Distinct people besides the owner with access, whether shared directly or through a workspace group they belong to.
      - `shared_with_everyone` boolean: Whether every workspace member has access to the group.
      - `everyone_role` 'admin' | 'editor' | 'commenter' | 'viewer', nullable: The preset role every workspace member has, when shared with everyone. None for a workspace custom role.
    - `created_at_unix_secs` integer, required
  - `next_cursor` string, nullable: Cursor to pass to the next request to fetch the following page.
  - `has_more` boolean: Whether more conversation groups are available beyond this page.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-02** `79b03ec785e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/realtime/conversation-groups/get.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/1fbf939a1e97?raw)