---
title: "Update agent configuration"
method: PATCH
path: "/api/v1/w/{wId}/assistant/agent_configurations/{sId}"
tags: ["Agents"]
---

# Update agent configuration

`PATCH /api/v1/w/{wId}/assistant/agent_configurations/{sId}`

Update the agent configuration identified by {sId} in the workspace identified by {wId}.

## Path parameters

- `wId` string, required
- `sId` string, required

## Request body

- object
  - `userFavorite` boolean
  - `agent` object
    - `handle` string
    - `description` string
    - `scope` 'visible' | 'hidden'
    - `avatar_url` string
    - `max_steps_per_run` number
    - `visualization_enabled` boolean
  - `instructions` string
  - `generation_settings` object
    - `model_id` string
    - `provider_id` string
    - `temperature` number
    - `reasoning_effort` string
  - `tags` object[]
    - `name` string
    - `kind` 'standard' | 'protected'
  - `editors` string[] — Emails of the workspace members to set as editors of the agent. Omitting this field keeps the current editors; providing it replaces the whole list.
  - `skills` object[] — Replaces the skills enabled on the agent configuration.
    - `sId` string, required
    - `name` string, required
  - `toolset` object[] — Replaces the full set of tools on the agent. Any tool not present in this array is removed, so send the complete desired toolset. Each entry resolves an MCP server by name (see configuration.mcp_server_name). Entries that cannot be resolved are not applied and are returned in the skippedActions field of the response rather than causing the whole request to fail.
    - `name` string
    - `description` string
    - `type` 'MCP'
    - `configuration` object
      - `mcp_server_name` string — Name of the MCP server to attach. Both built-in (internal) tools and remote MCP servers are supported. A remote MCP server must first be shared to a space (global or a regular space the caller can access); it is matched by its display name, which must be unambiguous within the workspace.

## Response `200`

Successfully updated agent configuration

- object
  - `agentConfiguration` AgentConfiguration
    - `id` integer
    - `sId` string — Unique string identifier for the agent configuration
    - `version` integer
    - `versionCreatedAt` string, nullable — Timestamp of when the version was created
    - `versionAuthorId` string, nullable — ID of the user who created this version
    - `name` string — Name of the agent configuration
    - `description` string — Description of the agent configuration
    - `instructions` string, nullable — Instructions for the agent
    - `pictureUrl` string — URL of the agent's picture
    - `status` string — Current status of the agent configuration
    - `scope` string — Scope of the agent configuration
    - `userFavorite` boolean — Status of the user favorite for this configuration
    - `model` object
      - `providerId` string — ID of the model provider
      - `modelId` string — ID of the specific model
      - `temperature` number
    - `actions` unknown[]
      - unknown
    - `maxStepsPerRun` integer
    - `templateId` string, nullable — ID of the template used for this configuration
  - `skippedActions` object[] — Toolset entries that could not be applied (e.g. the referenced MCP server was not found, is not shared to an accessible space, or the name was ambiguous). The request still succeeds; inspect this list to confirm every intended tool was attached.
    - `name` string
    - `reason` string

## Other responses

- `400` — Bad Request. Invalid or missing parameters.
- `401` — Unauthorized. Invalid or missing authentication token.
- `404` — Agent configuration not found.
- `500` — Internal Server Error.

## Changes

> 85 revisions in range; 1 not diffed.

- **2026-08-13** `ad905257873c` — 1 breaking, 3 warning
  - the `editors/items/` request property type/format changed from `object`/`` to `string`/`email`
  - removed the request property `editors/items/email`
  - removed the request property `editors/items/full_name`
  - removed the request property `editors/items/user_id`
- **2026-07-08** `2d1702fca1ee` — 1 info
  - added the new optional request property `toolset/items/configuration/mcp_server_name`
- **2026-06-19** `e5d6a51d91df` — 1 warning
  - removed the request property `toolset/items/configuration/mcp_server_name`
- **2026-06-17** `8848d86acfa5` — 1 info
  - added the new optional request property `toolset/items/configuration/mcp_server_name`
- **2026-06-07** `d541dc9c10e1` — 1 warning
  - removed the request property `toolset/items/configuration/mcp_server_name`

[Change history](https://skmtc.dev/dust-tt/apis/dust-api-documentation/changes/api/v1/w/:wId/assistant/agent_configurations/:sId/patch.md)

---

[API](https://skmtc.dev/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.dev/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/revisions/bd1d5314caa8/schema)