---
title: "Search platform abilities"
method: POST
path: "/platform/ability/search"
tags: ["Platform"]
---

# Search platform abilities

`POST /platform/ability/search`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/platform/ability/search`
- Auth: HTTP bearer

## Request body

- object
  - `search` string, required: The search query to find relevant abilities
  - `take` integer: The maximum number of results to return (1-100, default 10)

## Response `200`

The search was successful

- object
  - `items` object[], required
    - `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
    - `template` string: The original template identifier for the ability
    - `instruction` string, required
    - `schema` JsonSchemaObject, required: A JSON Schema object type definition (https://json-schema.org/). Represents an object schema with properties and validation rules.
      - `type` 'object', required: The schema type, must be "object"
      - `title` string: The schema title
      - `description` string: The schema description
      - `properties` object, required: Object property definitions
      - `required` string[]: Required property names
    - `bot` string
    - `file` string
    - `secret` string
    - `space` string
    - `computer` string
    - `provider` string
    - `icon` string, required
    - `tags` string[]
    - `setup` string
    - `commentary` string
    - `score` number, required: The text relevance score of the search result
    - `excerpt` string, required: An excerpt from the most relevant part of the ability
    - `link` string: The URL to the official ability 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)