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

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

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

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 104 revisions.

- **2026-09-03** `0f5503f5cd28` — 3 warning
- **2026-08-18** `5c2324662674` — 1 info
- **2026-08-07** `06cac6a7c5bc` — 3 info
- **2026-08-06** `0a6cfa00296a` — 6 info
- **2026-07-26** `27581e60c0cf` — 1 info

## Changes

- **2026-09-03** `0f5503f5cd28` — 3 warning
  - added the new `acp` enum value to the `allOf[#/components/schemas/Agent]/credStatus/oneOf[#/components/schemas/AgentCredStatus]/latestModel/harnessProvider` response property for the response status `200`
  - added the new `acp` enum value to the `allOf[#/components/schemas/Agent]/harnessProvider` response property for the response status `200`
  - added the new `acp` enum value to the `allOf[#/components/schemas/Agent]/provider` response property for the response status `200`
- **2026-08-18** `5c2324662674` — 1 info
  - added the optional property `profileSyncRejection` to the response with the `400` status
- **2026-08-07** `06cac6a7c5bc` — 3 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
- **2026-08-06** `0a6cfa00296a` — 6 info
  - the `claudeMd` request property's maxLength was increased from `65536` to `262144`
  - the `heartbeatMd` request property's maxLength was increased from `65536` to `262144`
  - the `identityMd` request property's maxLength was increased from `65536` to `262144`
  - the `setupScript` request property's maxLength was increased from `65536` to `262144`
  - the `soulMd` request property's maxLength was increased from `65536` to `262144`
  - the `toolsMd` request property's maxLength was increased from `65536` to `262144`
- **2026-07-26** `27581e60c0cf` — 1 info
  - added the new optional request property `avatar`

---

[Operation](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/docs/api/agents/:id/profile/put.md) · [API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [Page](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/agents/:id/profile/put)