---
title: "Update an agent"
method: PUT
path: "/api/agent_builder/agents/{id}"
tags: ["agent builder"]
---

# Update an agent

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

**Spaces method and path for this operation:**

<div><span class="operation-verb put">put</span>&nbsp;<span class="operation-path">/s/{space_id}/api/agent_builder/agents/{id}</span></div>

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Update an existing agent configuration. Use this endpoint to modify any aspect of the agent's behavior, appearance, or capabilities. To learn more about agents, refer to the [agents documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/agent-builder-agents).<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageAgents.

## Path parameters

- `id` string, required

## Headers

- `kbn-xsrf` string, required

## Request body

- object
  - `access_control` object
    - `access_mode` 'public' | 'shared' | 'private', required — **Technical Preview; added in 9.4.0.** Access-control mode: `public` (any privileged user can read/write), `shared` (any privileged user can read, only owner can write), `private` (only owner can read/write).
  - `avatar_color` string — Updated hex color code for the agent avatar.
  - `avatar_symbol` string — Updated symbol/initials for the agent avatar.
  - `configuration` object — Updated configuration settings for the agent.
    - `ai_indices` string[] — Array of AI indices to associate with the agent.
    - `connector_ids` string[] — Array of connector IDs to associate with the agent.
    - `enable_elastic_capabilities` boolean — When true, enables built-in Elastic capabilities for the agent.
    - `instructions` string — Updated system instructions that define the agent behavior.
    - `plugin_ids` string[] — Array of plugin IDs to assign to the agent.
    - `skill_ids` string[] — Array of skill IDs to be available to the agent.
    - `tools` object[]
      - `tool_ids` string[], required — Array of tool IDs that the agent can use.
    - `workflow_ids` string[]
  - `description` string — Updated description of what the agent does.
  - `labels` string[] — Updated labels for categorizing and organizing agents.
  - `name` string — Updated display name for the agent.

## Response `200`

Indicates a successful response

---

[API](https://skmtc.net/elastic/apis/kibana-apis.md) · [All operations](https://skmtc.net/elastic/apis/kibana-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/kibana-apis/versions/531c9e2a7d23/schema)