---
title: "List Gemini Agents"
method: GET
path: "/v1beta/agents"
tags: ["gemini_agents"]
---

# List Gemini Agents

`GET /v1beta/agents`

List all custom agents on the Gemini side.

Pass per-request Gemini credentials via the JSON-encoded
``litellm_params_template`` query parameter. Flat query parameters
(e.g. ``?api_key=AIza...``) are intentionally ignored — see
``_merge_query_params_into_data`` for the rationale.

```bash
curl "http://localhost:4000/v1beta/agents?litellm_params_template=%7B%22api_key%22%3A%22AIza...%22%7D" \
    -H "Authorization: Bearer sk-..."
```

## Response `200`

Successful Response

- unknown

## Changes

- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `gemini_agents` added
  - api tag `gemini managed agents` removed
- **2026-09-18** `082b5fabd909` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/v1beta/agents/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/3b2b241e4b0b?raw)