---
title: "Update Installed Skill"
method: POST
path: "/v1/workspaces/{workspace}/skills/{skill_id}/update"
tags: ["v1", "protected", "skills"]
---

# Update Installed Skill

`POST /v1/workspaces/{workspace}/skills/{skill_id}/update`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Move an installed catalog skill to its catalog item's current version.

## Path parameters

- `skill_id` string, uuid, required
- `workspace` string, required: Slug of the workspace the request acts in

## Query parameters

- `discard_changes` boolean: Update a skill edited in this workspace, discarding the edit

## Response `200`

Successful Response

- SkillResponse: Skill response model.
  - `created_at` string, required
  - `customized` boolean
  - `description` string, nullable, required
  - `id` string, required
  - `is_catalog` boolean
  - `name` string, required
  - `network_scope` string, required
  - `registry_item_id` string, nullable
  - `registry_name` string, nullable
  - `registry_scope` 'platform' | 'workspace', nullable
  - `registry_trust` 'official' | 'verified' | 'community' | 'private', nullable
  - `removed_upstream` boolean
  - `slug` string, required
  - `source_type` string, required
  - `source_url` string, nullable, required
  - `update_available` boolean
  - `updated_at` string, required
  - `workspace_id` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `32e3ecc10543`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/workspaces/:workspace/skills/:skill_id/update/post.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) - [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/5b651833a114?raw)