Update Operator Entity

Edit an operator entity, make it the default, or both. Send only the fields to change; address_full accepts null to clear it.

The entity must be complete after the change, or the request returns 422 naming the missing fields. This also applies to a default entity carried over from the operator_* organisation fields.

The identifier (identifier_type and eori, normalised) is validated when the edit changes it, and when the edit sets is_default: true on an entity that is not yet the default, because that copies the identifier into the organisation's defaults. Any other edit of an entity holding a value TRACES refuses is accepted; the value still blocks submit.

is_default accepts only true. To move the default, set it on the entity that should take over.

Editing the default entity, or making another entity the default, changes the operator_* fields on the organisation. It records an operator.defaults_changed event on each open statement that follows the default.

Statements that already copied this entity keep the old details. Send operator_entity_id on them again to pick up the edit.

StatusWhen
404No entity with this id in the acting organisation
422The edited entity is incomplete, or the identifier is invalid and the edit either changes it or promotes the entity to default. An edit that does neither is accepted even when the stored identifier is refused.

Required scope: organizations:write