# Allow screen capture of my window for a while

Lets the signed-in person's own desktop window be screenshot and screen-recorded for a stretch — {minutes}, thirty when the body says nothing, clamped to 1..120. Answers the same shape the read does, mode and style together, and the window is server-side, so it holds on their other machines too. A seat an operator set to locked is refused with 409 screen_capture_locked; one already off is a no-op, because nothing is hidden to permit. One person's own state, and it lands in the workspace's activity feed.

Access class: `workspace`.

## Endpoint

`POST /v1/me/screen-capture/allow`

## Request body

Content type: `application/json`.

```json
{
  "body": {
    "minutes": 1
  },
  "params": {},
  "query": {}
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "allowedUntil": "string",
    "mode": "string",
    "style": "string"
  }
}
```

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