---
title: "Update a skill"
method: PUT
path: "/api/agent_builder/skills/{skillId}"
tags: ["agent builder"]
---

# Update a skill

`PUT /api/agent_builder/skills/{skillId}`

**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/skills/{skillId}</span></div>

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

Update an existing user-created skill. To learn more about Agent Builder skills, refer to the [skills documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/skills).<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageSkills.

## Path parameters

- `skillId` string, required

## Headers

- `kbn-xsrf` string, required

## Request body

- object
  - `content` string — Updated skill instructions content.
  - `description` string — Updated description.
  - `name` string — Updated name for the skill.
  - `referenced_content` object[]
    - `content` string, required — Content of the reference.
    - `name` string, required — Name of the referenced content.
    - `relativePath` string, required — Relative path of the referenced content.
  - `tool_ids` string[] — Updated tool IDs from the tool registry.

## 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/revisions/deb2e8b751e7/schema)