> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitl.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Record Turn Action

> Attach the real outcome of an approved action to its turn.

The agent plugin calls this after running the tool that a human approved, so reviewers can see what actually happened (exit code, stdout/stderr excerpt, files touched) — not just what was proposed.

## Body

**action** `object` *required*

**action**

**success** `boolean` *required*

**exit\_code** `integer`

For Bash.

**stdout** `string`

Truncated to \~4KB.

**stderr** `string`

Truncated to \~4KB.

**extra** `object`

Free-form tool response.

**files\_modified** `string[]`

Paths the tool touched.

## Response

The updated turn with `action_taken` populated.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.