# File Assistant Feedback

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

POST `/v1/feedback`

For an Assistant to tell us, on its own judgment, what the API lacks (`feature_request`), got wrong (`bug`) or made hard (`improvement`). Free and not a Run.

Stored with the note: your Organization, the user and the API key or connected Assistant that filed it, and the request id.

- Who may file: any API key, read-only included, whatever the Balance.
- Not for: an empty Balance, an unavailable Source, a rate limit, a not-found, or the Customer's own invalid input.
- Write-only: read by ShortsIntel staff. It cannot be read back and no reply is sent.
- Limit: 20 notes per day per Organization.

## Price

Free.

## Request body

`application/json`

object

- `kind` string required one of `feature_request`, `bug`, `improvement` What the note is about. `feature_request`: the Customer wanted something the API does not do. `bug`: a call returned an error or data that looks wrong. `improvement`: a description or parameter was misleading or hard to use.
- `summary` string required length 1 to 200 The note in one line.
- `details` string required length 1 to 2000 What the Customer was trying to do, what happened, and what was expected. Leave out personal data, secrets and anything unrelated to the request.
- `tool` string length 1 to 128 The MCP tool the note is about, by its current name, such as `search_videos`. An unknown name is refused.
- `run_id` string length 1 to 128 The Run the note is about. Stored as given.
- `request_id` string length 1 to 128 The `X-Request-Id` (a problem's `request_id`) of the call the note is about. Stored as given.

## Responses

### 201 Created

`{ id, received: true }`.

object

- `id` string required The note's id.
- `received` boolean required always `true`

### 400 Bad Request

`invalid_request` — a malformed body, a missing or unknown `kind`, an empty or over-long `summary` or `details`, or a `tool` that is not a current MCP tool.

Code: `invalid_request`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 401 Unauthorized

Codes: `missing_authorization`, `invalid_key`, `key_revoked`, `key_expired`, `invalid_token`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 429 Too Many Requests

`rate_limit_exceeded`, with `Retry-After`: the request limit, or the 20 notes per day one Organization may file.

Code: `rate_limit_exceeded`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

## Request samples

curl:

```bash
curl -X POST "https://www.shortsintel.com/v1/feedback" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"feature_request","summary":"No way to list the pinned Videos of a Creator","details":"The Customer asked which Videos a Creator has pinned. The Creator read returns recent Videos only. Expected a pinned flag on each Video.","tool":"get_creator"}'
```

TypeScript:

```typescript
const response = await fetch(
  "https://www.shortsintel.com/v1/feedback",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "kind": "feature_request",
      "summary": "No way to list the pinned Videos of a Creator",
      "details": "The Customer asked which Videos a Creator has pinned. The Creator read returns recent Videos only. Expected a pinned flag on each Video.",
      "tool": "get_creator"
    }),
  },
);

if (!response.ok) {
  throw new Error(`ShortsIntel ${response.status}`);
}

const data = await response.json();
```

Python:

```python
import requests

response = requests.post(
    "https://www.shortsintel.com/v1/feedback",
    headers={
        "Authorization": "Bearer sk_live_YOUR_KEY",
        "Content-Type": "application/json",
    },
    json={
        "kind": "feature_request",
        "summary": "No way to list the pinned Videos of a Creator",
        "details": "The Customer asked which Videos a Creator has pinned. The Creator read returns recent Videos only. Expected a pinned flag on each Video.",
        "tool": "get_creator",
    },
)
response.raise_for_status()

data = response.json()
```

201 · `{ id, received: true }`.

```json
{
  "id": "cmi7x2q9d0001l504h3k9a1bz",
  "received": true
}
```

[Previous Read your spend log](https://www.shortsintel.com/docs/reference/account/get-usage)
