# update-agent

Update an existing AI agent on a live LiteLLM proxy. Ask for the agent_id and what to change (model, description, MCP servers), then call PATCH /v1/agents/{agent_id}.

Skill by LiteLLM. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add berriai/litellm-skills --skill update-agent
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add berriai/litellm-skills --skill update-agent -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.
- Runs shell commands: Its steps run shell commands in your terminal.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 87. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/berriai/litellm-skills/update-agent)

## Source

[Open the source](https://github.com/berriai/litellm-skills/tree/HEAD/update-agent). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: update-agent
description: >
  Update an existing AI agent on a live LiteLLM proxy. Ask for the agent_id
  and what to change (model, description, MCP servers), then call PATCH /v1/agents/{agent_id}.
license: MIT
compatibility: Requires curl.
metadata:
  author: BerriAI
  version: "1.0"
allowed-tools: Bash(curl:*)
---

# Update Agent

Update an existing AI agent on a live LiteLLM proxy.

## Setup

```
LITELLM_BASE_URL  — e.g. https://my-proxy.example.com
LITELLM_API_KEY   — proxy admin key
```

## Ask the user

1. **agent_id** — if they don't have it, list first:
   ```bash
   curl -s "$BASE/v1/agents" -H "Authorization: Bearer $KEY"
   ```
2. **What to change** — any combination of:
   - `model` (swap the underlying model)
   - `description`
   - `tpm_limit` / `rpm_limit`
   - MCP server access

## Run

Use PATCH to update only the changed fields:

```bash
curl -s -X PATCH "$BASE/v1/agents/<agent_id>" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "litellm_params": {"model": "<new_model>"},
    "agent_card_params": {"description": "<new_description>"}
  }'
```

## Output

Show the updated agent name, model, and description. Confirm the agent ID is unchanged.
````

- Previous: [update-user](https://syn4pse.dev/terminal/litellm-update-user.md)
- Next: [update-team](https://syn4pse.dev/terminal/litellm-update-team.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
