---
title: "Authenticate as Bot"
method: POST
path: "/bots/login"
tags: ["Bots"]
---

# Authenticate as Bot

`POST /bots/login`

## Request

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

Exchange a bot ID and secret token for a JWT access token.

## Request body

- BotLoginPayload
  - `botId` string, uuid, required
  - `token` string, required

## Response `200`

- TokenPair
  - `accessToken` string, required
  - `refreshToken` string, nullable: If the refresh token is not provided, you can continue using the same refresh token.

## Changes

- **2026-03-07** `149a167969e8`: 1 info
  - endpoint added
- **2025-09-22** `2792e551a954`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/mikotoio/apis/mikoto-superego/changes/bots/login/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)
