---
title: "List Bots"
method: GET
path: "/bots/"
tags: ["Bots"]
---

# List Bots

`GET /bots/`

## Request

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

## Response `200`

- BotInfo[]
  - `id` string, uuid, required
  - `lastTokenRegeneratedAt` string, date-time, nullable
  - `name` string, required
  - `ownerId` string, uuid, required
  - `permissions` string[], required
  - `user` UserExt, nullable: User with extended data including handle
    - `avatar` string, nullable
    - `category` 'BOT' | 'UNVERIFIED', nullable
    - `description` string, nullable
    - `handle` string, nullable: The user's handle (if claimed)
    - `id` string, uuid, required
    - `name` string, required
    - `spaceOrder` string[], nullable: Persisted ordering of the user's spaces in the sidebar. Always present on responses; optional in the schema so the base `User` shape remains structurally assignable to `UserExt`.
  - `visibility` 'PUBLIC' | 'PRIVATE', required

## Changes

- **2026-05-19** `7d22ce9ed272`: 1 info
  - added the optional property `items/user/anyOf[#/components/schemas/UserExt]/spaceOrder` to the response with the `200` status
- **2026-03-08** `cb61da4b3f2d`: 4 info
  - added the optional property `items/lastTokenRegeneratedAt` to the response with the `200` status
  - added the optional property `items/user` to the response with the `200` status
  - added the required property `items/permissions` to the response with the `200` status
  - added the required property `items/visibility` to the response with the `200` status
- **2026-03-06** `e1610c61d1ee`: 1 info
  - removed the required write-only property `items/secret` from the response with the `200` status
- **2026-03-04** `ef4658f84894`: 1 info
  - the response required property `items/secret` became write-only for the status `200`
- **2025-09-22** `2792e551a954`: 2 breaking, 2 warning, 1 info
  - removed the required property `items/permissions` from the response with the `200` status
  - removed the required property `items/visibility` from the response with the `200` status
  - removed the optional property `items/lastTokenRegeneratedAt` from the response with the `200` status
  - removed the optional property `items/user` from the response with the `200` status
  - …1 more

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