---
title: "UpdateAgentBody"
description: "Request body for updating an Agent."
section: "Reference"
group: "Types"
order: 5
---

## Definition

```ts
interface UpdateAgentBody {
  name?: string | undefined;
  description?: string | undefined;
  runtimeUserId?: string | null | undefined;
}
```

## Fields

| Field           | Type                          | Notes                                                                                                                                                                                              |
| --------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`          | `string \| undefined`         | `optional` — New name                                                                                                                                                                              |
| `description`   | `string \| undefined`         | `optional` — New description                                                                                                                                                                       |
| `runtimeUserId` | `string \| null \| undefined` | `optional` — Override the workspace default service user as the runtime caller when this agent runs headlessly. Null clears the override (inherit workspace default). Workspace-admin-only to set. |