## TL;DR

The record is locked by an approval process. Either approve/reject it first, or have the admin unlock it, then make your change.

## Error

```text
ENTITY_IS_LOCKED: the entity is locked for editing
```

## Steps

1. Check whether an approval process holds the record Expected: you confirm the lock source.
2. Complete or recall the approval Expected: the lock releases.
3. Or ask the admin to unlock the record Expected: it is editable.
4. Re-run your update Expected: it succeeds.

## When to use

- ENTITY_IS_LOCKED
- An approval process locked the record

## When not to use

- No approval is pending (then check for other lock sources)
- You need to edit locked records routinely (then adjust the approval config)

## Tool compatibility

- Salesforce approval processes
- Record locking

## Variant phrasings

### entity is locked salesforce

An approval process holds it. Complete or unlock first.

### ENTITY_IS_LOCKED

Same: the record is locked for editing.

## Why it happens

Agents do not know about approval state; they just see an update fail. The lock is invisible in the record itself.

## Edge cases

- Locked records can still be updated by the approval process itself
- Bulk updates should skip locked records and report them

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_3UYki9XVxhj_PCzQbsZqqA