---
title: "Get the features that are enabled for the requesting bot"
method: POST
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/bot/ask-features"
tags: ["bot"]
---

# Get the features that are enabled for the requesting bot

`POST /ocs/v2.php/apps/spreed/api/{apiVersion}/bot/ask-features`

Allows bots to check which features an administrator has enabled for them, without requiring administrator credentials. The request is signed with the shared bot secret like all other bot requests: the signature is computed over the random seed and the conversation token sent in the request body, which is used to look the bot up. Keeping the token in the signed body binds the request to the conversation, so the signature headers on their own cannot be replayed.
Required capability: `bot-features-api`

## Path parameters

- `apiVersion` 'v1', required

## Headers

- `x-nextcloud-talk-bot-random` string
- `x-nextcloud-talk-bot-signature` string
- `OCS-APIRequest` boolean, required

## Request body

- object
  - `token` string, required — Conversation token

## Response `200`

Bot features returned

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` BotFeatures, required
      - `features` integer, required — Feature flags enabled for the bot (see [constants list](https://nextcloud-talk.readthedocs.io/en/latest/constants#bot-features))

## Other responses

- `400` — Missing or malformed signature headers
- `401` — Bot could not be verified for the conversation

## Changes

> 62 revisions in range; 2 could not be searched.

- **2026-07-18** `f8eb793c485f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nextcloud/apis/spreed-full/changes/ocs/v2.php/apps/spreed/api/:apiVersion/bot/ask-features/post.md)

---

[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)