---
title: "Update an agent"
method: PATCH
path: "/api/agents/{agent_id}"
tags: ["Agents"]
---

# Update an agent

`PATCH /api/agents/{agent_id}`

## Path parameters

- `agent_id` string, required

## Request body

- CreateAgentRequest
  - `name` string, required
  - `owner_id` string, required
  - `runtime` string — Built-in runtime ID or registered runtime harness alias. Stored in agent config.
  - `model` string
  - `system` string
  - `description` string
  - `prompt` string — Fallback system prompt when `system` is omitted.
  - `config` object
  - `tools` union — Runtime tool definitions.
    - object[]
    - object

## Response `200`

Updated agent

- Agent
  - `id` string
  - `name` string
  - `model` string
  - `system` string
  - `tools` object
  - `config` object — Runtime-specific config. For runtime-backed agents this usually includes `runtime`.
  - `owner_id` string, nullable
  - `status` string
  - `description` string, nullable
  - `harness` string
  - `created_at` integer

## Other responses

- `401` — Unauthorized
- `404` — Agent not found

---

[API](https://skmtc.net/litellm-agent-platform/apis/litellm-agent-platform-api.md) · [All operations](https://skmtc.net/litellm-agent-platform/apis/litellm-agent-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/litellm-agent-platform/litellm-agent-platform-api/versions/92039c29a228/schema)