---
title: "UpdateSkill"
method: PATCH
path: "/v2/skills/{skill_id}"
tags: ["beta.skills"]
---

# UpdateSkill

`PATCH /v2/skills/{skill_id}`

UpdateSkill

## Path parameters

- `skill_id` string, required

## Request body

- object
  - `sharingScope` 'sharing_scope_unspecified' | 'private' | 'workspace'

## Response `200`

Success

- Skill
  - `id` string
  - `name` string — Stable object name.
  - `definition` SkillDefinition — Versioned skill content.
    - `description` string — Model-facing trigger and usage description.
    - `body` string — Skill body content.
    - `assets` object — Additional files available to the skill.
  - `version` integer
  - `notes` string — Notes for this version.
  - `aliases` string[] — Aliases pointing to this version.
  - `sharingScope` 'sharing_scope_unspecified' | 'private' | 'workspace'
  - `createdAt` string, date-time — RFC 3339 timestamp.
  - `updatedAt` string, date-time — RFC 3339 timestamp.
  - `latestVersion` integer — Latest version number.

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/versions/933c4ebdcd72/schema)