---
title: "Replace bot skills"
method: POST
path: "/bot/setMySkills"
tags: ["Bot"]
---

# Replace bot skills

`POST /bot/setMySkills`

## Request

- Base URL: `https://api.inline.chat`
- URL: `https://api.inline.chat/bot/setMySkills`
- Auth: none required

Replaces the authenticated bot's complete installed-skill catalog. Send an empty array to clear it.

## Headers

- `authorization` string, required

## Request body

- SetMySkillsInput: Installed skills to publish for the authenticated bot harness.
  - `skills` BotSkill[], required: Complete replacement catalog of up to 250 installed skills. Send an empty array to clear it.
    - `key` string, required: Stable harness activation key.
    - `name` string, required: Human-facing installed skill name.
    - `description` string
    - `sort_order` integer: An integer that can be represented exactly by a JavaScript number

## Response `200`

Successful response for an action with no return value.

- BotEmptySuccess: Successful response for an action with no return value.
  - `ok` true, required: Always true for a successful request.
  - `result` object, required: Method-specific response payload.

## Other responses

- `400`: The request parameters are missing or invalid.
- `401`: The bot token is missing or invalid.
- `403`: The bot is not allowed to perform this action.
- `404`: The requested method or resource was not found.
- `429`: The bot is sending faster than its pacing budget. Wait `parameters.retry_after` seconds, also sent as `Retry-After`.
- `500`: The server could not complete the request.

## Changes

- **2026-10-29** `3eb50c9c5b92`: 1 info
  - added the non-success response with the status `429`
- **2026-09-03** `eb2fa47b1f94`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/changes/bot/setMySkills/post.md)

---

[API](https://skmtc.dev/inline/apis/inline-bot-http-api-docs.md) - [All operations](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/revisions/bc9745589244?raw)