---
title: "Submit use-case tags for your rating"
method: PATCH
path: "/documents/{id}/rating/use-case"
tags: ["Documents"]
---

# Submit use-case tags for your rating

`PATCH /documents/{id}/rating/use-case`

## Request

- Base URL: `https://api.bankstatemently.com/v1`
- URL: `https://api.bankstatemently.com/v1/documents/{id}/rating/use-case`
- Auth: API key in header `X-API-Key`

Adds or updates use-case tags on the caller's own existing rating. A silent no-op (still 200) if the caller has not rated this document yet — use-case is only captured once a rating exists. Rate limit: 10 requests per minute.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `useCase` string[], required
  - `useCaseOther` string

## Response `200`

Use-case tags stored (or silently no-op'd if the caller has not rated this document yet).

- object
  - `data` object
    - `useCase` string[]
    - `useCaseOther` string, nullable

## Other responses

- `400`: Invalid use-case parameters.
- `401`: Authentication failed, API key revoked, or API key expired.
- `429`: Too many requests. Wait the number of seconds indicated by the `Retry-After` header.
- `500`: An unexpected server error occurred.

---

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