---
title: "Replace the organization skill (org_admin; two-step; stale version answers 409)"
method: PUT
path: "/api/orgs/{orgId}/skill"
tags: ["orgs"]
---

# Replace the organization skill (org_admin; two-step; stale version answers 409)

`PUT /api/orgs/{orgId}/skill`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/orgs/{orgId}/skill`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Request body

- PutSkillBody
  - `markdown` string, required
  - `version` string
  - `note` string
  - `confirm` boolean: false = return a preview only; true = apply the change.

## Response `200`

Preview or the new skill.

- union
  - object
    - `preview` object, required
  - OrgSkill
    - `orgId` string, required
    - `markdown` string, required
    - `version` string, required
    - `updatedAt` string
    - `updatedBy` string
    - `canEdit` boolean, required
    - `maxChars` integer, required

## Other responses

- `403`: Insufficient role.
- `409`: Stale version.

---

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