---
title: "Create Gemini Agent"
method: POST
path: "/v1beta/agents"
tags: ["gemini_agents"]
---

# Create Gemini Agent

`POST /v1beta/agents`

Create a named custom agent on the Gemini side.

Example:
```bash
curl -X POST "http://localhost:4000/v1beta/agents" \
    -H "Authorization: Bearer sk-..." \
    -H "Content-Type: application/json" \
    -d '{
        "name": "my-custom-slides-agent",
        "base_agent": "waverunner",
        "instructions": "You are a helpful assistant that creates slides.",
        "base_environment": {
            "type": "remote",
            "sources": [
                {"type": "gcs", "source": "gs://eap-templates/slides-skill",
                 "target": "/.agents/skills/slides-skill"}
            ]
        }
    }'
```

## 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/post.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/c71315002afa?raw)