---
title: "List admin bots"
method: GET
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/bot/admin"
tags: ["settings"]
---

# List admin bots

`GET /ocs/v2.php/apps/spreed/api/{apiVersion}/bot/admin`

This endpoint requires admin access

## Path parameters

- `apiVersion` 'v1', required

## Headers

- `OCS-APIRequest` boolean, required

## Response `200`

Bot list returned

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` BotWithDetails[], required
      - `description` string, nullable, required — A longer description of the bot helping moderators to decide if they want to enable this bot
      - `id` integer, required — Unique numeric identifier of the bot on this server
      - `name` string, required — Display name of the bot shown as author when it posts a message or reaction
      - `state` integer, required — One of the [Bot states](https://nextcloud-talk.readthedocs.io/en/latest/constants#bot-states)
      - `error_count` integer, required — Number of consecutive errors
      - `features` integer, required — Feature flags for the bot (see [constants list](https://nextcloud-talk.readthedocs.io/en/latest/constants#bot-features))
      - `last_error_date` integer, required — UNIX timestamp of the last error
      - `last_error_message` string, required — The last exception message or error response information when trying to reach the bot
      - `url` string, required — URL endpoint that is triggered by this bot
      - `url_hash` string, required — Hash of the URL prefixed with `bot-` serves as `actorId`

## Other responses

- `401` — Current user is not logged in
- `403` — Logged in account must be an admin

---

[API](https://skmtc.dev/nextcloud/apis/spreed-full.md) · [All operations](https://skmtc.dev/nextcloud/apis/spreed-full/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nextcloud/spreed-full/revisions/41d6458d6d6e/schema)