# List AI Search endpoints

Launch stage: Public Preview

`GET /api/2.0/ai-search/{parent=workspaces/*}/endpoints`

List AI Search endpoints in a workspace.

API scopes: ai-search

## Path parameters

- `parent` (string, required)
  The Workspace that owns this collection of endpoints.
   Format: `workspaces/{workspace_id}`

## Query parameters

- `page_size` (int32, optional)
  Best-effort upper bound on the number of results to return. Honored as an upper
   bound by the shim: `page_size` only narrows the legacy backend's response, never
   widens it, so the practical cap is `min(page_size, legacy_fixed_page_size)`.
- `page_token` (string, optional)
  Page token from a previous response. If not provided, returns the first page.

## Returns

Returns a list of Endpoint objects.

## Response

```json
{
  "endpoints": [
    {
      "name": "docs-endpoint",
      "creator": "john@example.com",
      "create_time": "2023-12-08T05:31:52.061Z",
      "update_time": "2023-12-08T05:31:52.061Z",
      "endpoint_type": "string",
      "last_updated_user": "john@example.com",
      "id": "c56bf0a9-4929-4bd4-8bd5-d82ca62f9c76",
      "endpoint_status": {},
      "index_count": 0,
      "budget_policy_id": "string",
      "effective_budget_policy_id": "8b0444ff-8b60-48b0-9d31-e391f6126e0f",
      "custom_tags": [
        {}
      ],
      "throughput_info": {},
      "scaling_info": {},
      "usage_policy_id": "string",
      "replica_count": 0,
      "target_qps": 0
    }
  ],
  "next_page_token": "string"
}
```