---
title: "Update agent profile (lenient)"
method: PUT
path: "/api/v1/agents/{id}"
tags: ["agents"]
---

# Update agent profile (lenient)

`PUT /api/v1/agents/{id}`

## Request

- Base URL: `https://api.agenticcontrolplane.com`
- URL: `https://api.agenticcontrolplane.com/api/v1/agents/{id}`
- Auth: HTTP bearer

Field-by-field update; unknown fields ignored. Prefer PATCH, which validates strictly.

## Request body

- object: Agent profile fields. On PATCH the body is strict (unknown fields rejected) and `model` must be on the platform allowlist; see /api/v1 docs for per-field bounds.
  - `name` string
  - `description` string
  - `icon` string
  - `model` string: Must be an allow-listed model id.
  - `systemPrompt` string
  - `enabledTools` string[]
  - `scopes` string[]
  - `maxToolCalls` integer
  - `maxBudgetCents` integer
  - `maxDurationMs` integer
  - `maxToolRounds` integer
  - `delegatable` boolean
  - `canDelegate` boolean
  - `maxDelegationDepth` integer

## Response `200`

Updated.

- object
  - `ok` boolean

## Other responses

- `401`: Missing, malformed, invalid, or revoked gsk_ API key.
- `404`: Not found.
- `500`: Server error.

---

[API](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api.md) · [All operations](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcontrolplane/apis/agentic-control-plane-gateway-api/revisions/161819f3df00?raw)