---
title: "Update a skillset ability"
method: POST
path: "/skillset/{skillsetId}/ability/{abilityId}/update"
tags: ["Skillset Ability"]
---

# Update a skillset ability

`POST /skillset/{skillsetId}/ability/{abilityId}/update`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/skillset/{skillsetId}/ability/{abilityId}/update`
- Auth: HTTP bearer

## Path parameters

- `skillsetId` string, required
- `abilityId` string, required

## Request body

- object: Blueprint properties
  - `alias` string, nullable: The unique alias for the instance
  - `name` string: The associated name
  - `description` string: The associated description
  - `meta` Meta: Meta data information
  - `blueprintId` string, nullable: The ID of the blueprint
  - `linkedSecretId` string, nullable: The ID of the secret associated with the ability
  - `linkedFileId` string, nullable: The ID of the file associated with the ability
  - `linkedBotId` string, nullable: The ID of the bot associated with the ability
  - `linkedSpaceId` string, nullable: The ID of the space associated with the ability
  - `linkedComputerId` string, nullable: The ID of the computer the ability runs shell commands on
  - `instruction` string: The text to update the ability with
  - `state` 'enabled' | 'disabled': The lifecycle state of a resource - toggle it on/off without deleting it

## Response `200`

The ability was updated successfully

- object
  - `id` string, required: The ID of the updated ability

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)