> For AI agents: the documentation index is at https://docs.gethandup.dev/llms.txt. Append .md to any page URL (without the trailing slash) for Markdown, for example https://docs.gethandup.dev/cli.md.

# yolo_put

`PUT /v1/yolo`

Set YOLO mode, optionally `for` a duration after which it turns off. Applies to requests created afterwards; matching rules still win and requests that need a human answer (questions, fields, feedback policies, several approve options) stay pending. Emits `yolo.changed`.

## Request Body required

Media type: `application/json`

`object`

`PUT /v1/yolo` body.

- **mode** (required): `string`

  Allowed values: `off` `on` `hard`

- **for**: `string | null`

  Optional duration (`15m`, `1h`); absent = until turned off. Not valid with `off`.

## Responses

### 200

Media type: `application/json`

`object`

`GET`/`PUT /v1/yolo` response and the `yolo.changed` event payload.

- **mode** (required): `string`

  Allowed values: `off` `on` `hard`

- **until**: `integer | null` format: int64, >= 0

  Unix milliseconds when the mode turns itself off; null = until turned off.

### 400

Invalid mode or duration

### 403

Remote device without decide scope
