---
title: "Send the Toma team a feature request"
method: POST
path: "/api/feature-requests"
---

# Send the Toma team a feature request

`POST /api/feature-requests`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/feature-requests`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Something Toma should add or do differently. Any signed-in member. A few per account per hour. Same as the submit_feature_request MCP tool.

## Request body

- object
  - `description` string, required: What the human wants Toma to do, and why, in plain words.

## Response `201`

The stored request.

- FeatureRequest
  - `id` string, required
  - `description` string, required
  - `createdAt` string, date-time, required

## Other responses

- `400`: Empty or too long.
- `401`: No valid session or API key.
- `413`: The request body exceeds 2097152 bytes.
- `429`: Too many feature requests this hour.

---

[API](https://skmtc.dev/toma/apis/toma-api.md) - [All operations](https://skmtc.dev/toma/apis/toma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toma/apis/toma-api/revisions/b4e56e1db5a2?raw)