---
title: "Retrieve a list of skillset abilities"
method: GET
path: "/skillset/{skillsetId}/ability/list"
tags: ["Skillset Ability"]
---

# Retrieve a list of skillset abilities

`GET /skillset/{skillsetId}/ability/list`

## Request

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

## Path parameters

- `skillsetId` string, required: The ID of the skillset

## Query parameters

- `cursor` string: The cursor to use for pagination
- `order` 'asc' | 'desc': The order of the paginated items
- `take` integer: The number of items to retrieve

## Response `200`

The list of abilities was retrieved successfully

- object
  - `items` object[], required
    - `alias` string, nullable: The unique alias for the instance
    - `name` string, required: The associated name
    - `description` string, required: The associated description
    - `meta` Meta: Meta data information
    - `id` string, required: The instance ID
    - `createdAt` number, required: The timestamp (ms) when the instance was created
    - `updatedAt` number, required: The timestamp (ms) when the instance was updated
    - `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, required
    - `state` 'enabled' | 'disabled': The lifecycle state of a resource - toggle it on/off without deleting it
  - `cursor` string, required: Cursor for fetching the next page

## 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)