# File a record I opened

The client saying the signed-in person opened one record: `key` (the page's key, or a board's `board-<hex>`), `rowId`, and `via` — palette, mention, neo, grid or link. An open that came off a search also sends the `term` and the hit's `position` (1 for the first), both or neither; the term is kept only as a hash. Answers 204. A record the person cannot read is a 404, the answer the one-record read gives it. Each person keeps their newest 500 opens, and get_me_recent-records reads them back.

Access class: `workspace`.

## Endpoint

`POST /v1/me/record-opens`

## Request body

Content type: `application/json`.

```json
{
  "key": "string",
  "position": 1.5,
  "rowId": "",
  "term": "string",
  "via": "string"
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
