---
title: "Update agent profile (role, description, capabilities, etc.)"
method: PUT
path: "/api/agents/{id}/profile"
tags: ["Agents"]
---

# Update agent profile (role, description, capabilities, etc.)

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

## Path parameters

- `id` string, required

## Request body

- object
  - `role` string
  - `description` string
  - `capabilities` string[]
  - `claudeMd` string
  - `soulMd` string
  - `identityMd` string
  - `setupScript` string
  - `toolsMd` string
  - `heartbeatMd` string
  - `avatar` object, nullable
    - `type` 'lucide', required
    - `icon` string, required
    - `color` string
  - `changeSource` string
  - `changedByAgentId` string
  - `changeReason` string

## Response `200`

Profile updated

## Other responses

- `400` — Validation error
- `404` — Agent not found

## Changes

- **2026-07-26** `27581e60c0cf` — 1 info
  - added the new optional request property `avatar`

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/agents/:id/profile/put.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/4f62e32be8ec?raw)