---
title: "Update a skill you made"
method: PATCH
path: "/skills/{skillId}"
tags: ["Skills"]
---

# Update a skill you made

`PATCH /skills/{skillId}`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/skills/{skillId}`
- Auth: HTTP bearer

## Request body

- object
  - `name` string
  - `description` string
  - `outputType` string
  - `category` 'general' | 'brainstorm' | 'diagrams' | 'planning' | 'media'
  - `systemPrompt` string
  - `placeholder` string
  - `tags` string[]
  - `model` string

## Response `200`

OK

- Skill
  - `id` string
  - `slug` string, nullable
  - `name` string
  - `description` string
  - `outputType` string, nullable: The kind of item the skill shapes, in the skill library's own vocabulary (kanban, mindmap, markdown, swimlanediagram …).
  - `category` string
  - `tags` string[]
  - `placeholder` string
  - `scope` 'public' | 'team'
  - `author` object
    - `email` string
    - `name` string
  - `iconUrl` string, nullable
  - `uses` integer
  - `systemPrompt` string: Present on public skills and on your own.
  - `createdAt` string, date-time, nullable

## Other responses

- `429`: Too many requests.
- `4XX`: An error. See the envelope and the code list on the Errors page.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)