---
title: "Create a Bot"
method: POST
path: "/bots/"
tags: ["Bots"]
---

# Create a Bot

`POST /bots/`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- CreateBotPayload
  - `name` string, required

## Response `200`

- BotCreatedResponse
  - `id` string, uuid, required
  - `name` string, required
  - `ownerId` string, uuid, required
  - `token` string, required

## Changes

- **2026-03-04** `ef4658f84894`: 1 breaking, 1 info
  - removed the required property `secret` from the response with the `200` status
  - added the required property `token` to the response with the `200` status
- **2025-09-22** `2792e551a954`: 1 breaking, 1 info
  - removed the required property `token` from the response with the `200` status
  - added the required property `secret` to the response with the `200` status

[Operation history](https://skmtc.dev/mikotoio/apis/mikoto-superego/changes/bots/post.md)

---

[API](https://skmtc.dev/mikotoio/apis/mikoto-superego.md) - [All operations](https://skmtc.dev/mikotoio/apis/mikoto-superego/llms.txt) - [OpenAPI document](https://skmtc.dev/mikotoio/apis/mikoto-superego/revisions/55ae42443991?raw)
