> ## Documentation Index > Fetch the complete documentation index at: https://docs.threetone.in/llms.txt > Use this file to discover all available pages before exploring further. # List Agent Response Tests > Lists all agent response tests with pagination support and optional search filtering. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/convai/agent-testing openapi: 3.1.0 info: title: Threetone API Documentation description: >- This is the documentation for the Threetone API. You can use this API to use our service programmatically with API keys sent in the x-api-key header. You can create and manage API keys in the dashboard at https://threetone.in/app/developers/api-keys. version: '1.0' servers: - url: https://api.threetone.in description: Production security: [] paths: /v1/convai/agent-testing: get: summary: List Agent Response Tests description: >- Lists all agent response tests with pagination support and optional search filtering. operationId: list_chat_response_tests_route parameters: - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Used for fetching next page. Cursor is returned in the response. title: Cursor description: Used for fetching next page. Cursor is returned in the response. - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: >- How many Tests to return at maximum. Can not exceed 100, defaults to 30. default: 30 title: Page Size description: >- How many Tests to return at maximum. Can not exceed 100, defaults to 30. - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search query to filter tests by name. title: Search description: Search query to filter tests by name. - name: parent_folder_id in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter by parent folder ID. Use 'root' to get items in the root folder. title: Parent Folder Id description: >- Filter by parent folder ID. Use 'root' to get items in the root folder. - name: types in: query required: false schema: anyOf: - type: array items: $ref: '#/components/schemas/TestType' - type: 'null' description: >- If present, the endpoint will return only tests/folders of the given types. title: Types description: >- If present, the endpoint will return only tests/folders of the given types. - name: sort_mode in: query required: false schema: enum: - default - folders_first type: string description: >- Sort mode for listing tests. Use 'folders_first' to place folders before tests. default: default title: Sort Mode description: >- Sort mode for listing tests. Use 'folders_first' to place folders before tests. - name: sharing_mode in: query required: false schema: $ref: '#/components/schemas/TestSharingMode' description: >- Filter test visibility. Use `shared_with_me` to return only tests/folders shared with the current user that they did not create. default: all description: >- Filter test visibility. Use `shared_with_me` to return only tests/folders shared with the current user that they did not create. - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. title: X-Api-Key description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/GetTestsPageResponseModel' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: TestType: type: string enum: - llm - tool - simulation - folder title: TestType TestSharingMode: type: string enum: - all - shared_with_me title: TestSharingMode GetTestsPageResponseModel: properties: tests: items: $ref: '#/components/schemas/UnitTestSummaryResponseModel' type: array title: Tests next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor has_more: type: boolean title: Has More type: object required: - tests - has_more title: GetTestsPageResponseModel HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError UnitTestSummaryResponseModel: properties: id: type: string title: Id description: The ID of the test name: type: string title: Name description: Name of the test access_info: anyOf: - $ref: '#/components/schemas/ResourceAccessInfo' - type: 'null' description: The access information of the test created_at_unix_secs: type: integer title: Created At Unix Secs description: Creation time of the test in unix seconds last_updated_at_unix_secs: type: integer title: Last Updated At Unix Secs description: Last update time of the test in unix seconds type: $ref: '#/components/schemas/TestType' description: Type of the test or entity entity_type: $ref: '#/components/schemas/AgentTestEntityType' description: The type of entity (test or folder) default: test folder_parent_id: anyOf: - type: string - type: 'null' title: Folder Parent Id description: The ID of the parent folder folder_path: items: $ref: '#/components/schemas/AgentTestFolderPathSegmentResponseModel' type: array title: Folder Path description: The folder path segments from root to this entity children_count: anyOf: - type: integer - type: 'null' title: Children Count description: Number of direct children (tests and subfolders) for folders only type: object required: - id - name - created_at_unix_secs - last_updated_at_unix_secs - type title: UnitTestSummaryResponseModel ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ResourceAccessInfo: properties: is_creator: type: boolean title: Is Creator description: Whether the user making the request is the creator of the agent creator_name: type: string title: Creator Name description: Name of the agent's creator creator_email: type: string title: Creator Email description: Email of the agent's creator role: type: string enum: - admin - editor - commenter - viewer title: Role description: The role of the user making the request anonymous_access_level_override: anyOf: - type: string enum: - admin - editor - commenter - viewer - type: 'null' title: Anonymous Access Level Override description: >- The access level for anonymous users. If None, the resource is not shared publicly. access_source: anyOf: - type: string enum: - creator - explicit - workspace_admin - workspace_default - type: 'null' title: Access Source description: >- 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. type: object required: - is_creator - creator_name - creator_email - role title: ResourceAccessInfo example: access_source: creator creator_email: john.doe@example.com creator_name: John Doe is_creator: true role: admin AgentTestEntityType: type: string enum: - test - folder title: AgentTestEntityType AgentTestFolderPathSegmentResponseModel: properties: id: type: string title: Id name: type: string title: Name default: '' type: object required: - id title: AgentTestFolderPathSegmentResponseModel ````