ENTITY_IS_LOCKED: the entity is locked for editing" salesforce

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

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

• ENTITYISLOCKED
• 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.

ENTITYISLOCKED

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/pst3UYki9XVxhjPCzQbsZqqA

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

Thread query: "ENTITYISLOCKED: the entity is locked for editing" salesforce

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.