---
title: "Update Agent"
method: PUT
path: "/v1/orchestrator/agents/{agent_id}"
tags: ["Agent Orchestrator"]
---

# Update Agent

`PUT /v1/orchestrator/agents/{agent_id}`

## Request

- Base URL: `https://api.grafomem.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.grafomem.com/v1/orchestrator/agents/{agent_id}`
- Auth: none declared

Update an agent definition.

## Path parameters

- `agent_id` string, required

## Request body

- UpdateAgentRequest: Request body for PUT /v1/orchestrator/agents/{id}.
  - `name` string, nullable
  - `description` string, nullable
  - `model_id` string, nullable
  - `fallback_models` string[], nullable
  - `system_prompt` string, nullable
  - `memory_stores` string[], nullable
  - `tools` string[], nullable
  - `max_steps` integer, nullable
  - `max_tokens_per_step` integer, nullable
  - `temperature` number, nullable
  - `enabled` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/grafomem/apis/grafomem-cloud.md) · [All operations](https://skmtc.dev/grafomem/apis/grafomem-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/grafomem/apis/grafomem-cloud/revisions/a472af705375?raw)