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

# Edit an existing record

> Find a live record, stage an edit in a workspace, validate it, submit it, and read the result.

Runtime copies the live record into a workspace, keeps the proposed edit there,
and checks whether the live record changed before submission.

## Before you start

* [Check the active project](/runtime/orient).
* Identify the exact record and current value.
* Gather the source or reason for the new value.
* Check whether relationships or other records may be affected.
* Decide who will approve submission.

## Ask your agent

> Find the Acme account record and change its renewal date to September 30,
> 2026\. Stage the edit in a workspace named “Acme renewal correction.” Show me
> the current value, proposed value, source references, and validation result.
> Do not submit until I approve.

## Steps

<Steps>
  <Step title="Find and read the live record">
    The agent confirms the record, current value, relationships, and source references.
  </Step>

  <Step title="Open a workspace and copy the record">
    It opens one workspace for the edit and brings the live record into it.
  </Step>

  <Step title="Make the edit">
    It changes only the requested field and leaves the live record untouched.
  </Step>

  <Step title="Read and validate the workspace">
    It shows the proposed value, checks the Shape, and reports possible conflicts.
  </Step>

  <Step title="Approve and submit">
    Submit after review. The result states whether the project applied the edit or sent it for review.
  </Step>
</Steps>

## Verify

If the edit is live, open the record again and confirm the new value and source
references. If submission is pending, confirm that status instead.

## If the live record changed while you worked

Submission reports a conflict when someone changed the live record after the
workspace was opened. Reopen the current record, compare it with the staged
edit, and decide whether your change still applies. Do not create a new
workspace merely to avoid the conflict.

<Accordion title="Tool trace">
  ```text theme={null}
  penumbra_omnisearch
  → penumbra_read
  → penumbra_workspace_open
  → penumbra_workspace_hydrate
  → penumbra_workspace_modify
  → penumbra_workspace_read
  → penumbra_workspace_validate
  → approval
  → penumbra_workspace_submit
  → penumbra_read
  ```
</Accordion>