# Report client timings

Files how long the DESKTOP APP took — shell calls and screens (a page switch to painted, a skeleton's wait) — against the caller's workspace, as info runs of kind client. Body: `version`, `platform`, and `samples` (1 to 200 of `kind` call or screen, `name`, `count` ≥ 1, `totalMs`, `maxMs` ≤ totalMs); JSON under 32KB, rate-limited per session, accepted or refused whole. Written by the client's own timer, never by a person, and it answers no question about the desk.

Access class: `workspace`.

## Endpoint

`POST /v1/client/timings`

## Request body

Content type: `application/json`.

```json
{
  "events": [
    {
      "at": "string",
      "board": "string",
      "cache": "string",
      "kind": "string",
      "ms": 1.5,
      "name": "string",
      "requestId": "",
      "route": "string",
      "status": "string",
      "view": "string"
    }
  ],
  "platform": "string",
  "samples": [
    {
      "count": 1.5,
      "kind": "string",
      "maxMs": 1.5,
      "name": "string",
      "totalMs": 1.5
    }
  ],
  "version": "string"
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "accepted": true,
    "events": {
      "dropped": 1.5,
      "stored": 1.5
    }
  }
}
```

### 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"
}
```
