---
title: "List Agent Response Tests"
method: GET
path: "/v1/convai/agent-testing"
---

# List Agent Response Tests

`GET /v1/convai/agent-testing`

Lists all agent response tests with pagination support and optional search filtering.

## Query parameters

- `cursor` string, nullable — Used for fetching next page. Cursor is returned in the response.
- `page_size` integer — How many Tests to return at maximum. Can not exceed 100, defaults to 30.
- `search` string, nullable — Search query to filter tests by name.
- `parent_folder_id` string, nullable — Filter by parent folder ID. Use 'root' to get items in the root folder.
- `types` TestType[], nullable — If present, the endpoint will return only tests/folders of the given types.
- `include_folders` boolean, nullable — Deprecated. Use the `types` query param and include `folder` instead.
- `sort_mode` 'default' | 'folders_first' — Sort mode for listing tests. Use 'folders_first' to place folders before tests.
- `sharing_mode` 'all' | 'shared_with_me'

## 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

- GetTestsPageResponseModel
  - `tests` UnitTestSummaryResponseModel[], required
    - `id` string, required — The ID of the test
    - `name` string, required — Name of the test
    - `access_info` ResourceAccessInfo
      - `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.
    - `created_at_unix_secs` integer, required — Creation time of the test in unix seconds
    - `last_updated_at_unix_secs` integer, required — Last update time of the test in unix seconds
    - `type` 'llm' | 'tool' | 'simulation' | 'folder', required
    - `entity_type` 'test' | 'folder'
    - `folder_parent_id` string, nullable — The ID of the parent folder
    - `folder_path` AgentTestFolderPathSegmentResponseModel[] — The folder path segments from root to this entity
      - `id` string, required
      - `name` string
    - `children_count` integer, nullable — Number of direct children (tests and subfolders) for folders only
    - `conversation_initiation_source` 'unknown' | 'android_sdk' | 'node_js_sdk' | 'react_native_sdk' | 'react_sdk' | 'js_sdk' | 'python_sdk' | 'widget' | 'sip_trunk' | 'twilio' | 'exotel' | 'genesys' | 'avaya' | 'audiocodes' | 'swift_sdk' | 'whatsapp' | 'twilio_sms' | 'flutter_sdk' | 'zendesk_integration' | 'slack_integration' | 'telegram_integration' | 'intercom_integration' | 'freshdesk_integration' | 'salesforce_integration' | 'template_preview' | 'genesys_bot_connector' | 'subagent_tool' — Enum representing the possible sources for conversation initiation.
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/3b2cee2701a3/schema)