---
title: "Update agent"
method: PATCH
path: "/agent/v1/agents/{id}"
tags: ["Agents"]
---

# Update agent

`PATCH /agent/v1/agents/{id}`

Updates an agent definition. Only provided fields are changed.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string — Updated agent display name
  - `description` string, nullable — Updated agent description. Pass null to clear if supported by the client.
  - `instructions` string — Updated system instructions that guide agent behavior
  - `model` string — Model identifier the agent should use for future runs
  - `vaultIds` string[], nullable — Vault IDs the agent can access directly. Pass null to clear.
  - `vaultGroups` string[], nullable — Vault group IDs the agent can access. Pass null to clear.
  - `enabledTools` string[], nullable — Allowlist of tools the agent can use. Mutually exclusive with disabledTools — set one or the other, not both. Pass null to clear.
  - `disabledTools` string[], nullable — Denylist of tools the agent cannot use. Mutually exclusive with enabledTools — set one or the other, not both. Pass null to clear.
  - `sandbox` object, nullable — Sandbox configuration override for future agent runs. Pass null to clear.

## Response `200`

Updated agent

- object
  - `id` string
  - `name` string
  - `description` string, nullable
  - `instructions` string
  - `model` string
  - `vaultIds` string[], nullable
  - `vaultGroups` string[], nullable
  - `enabledTools` string[], nullable
  - `disabledTools` string[], nullable
  - `sandbox` object, nullable
  - `isActive` boolean
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400` — No fields to update or missing agent ID
- `401` — Invalid API key
- `403` — No agent access
- `404` — Agent not found

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)