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.
| Status | When |
|---|---|
404 | No entity with this id in the acting organisation |
422 | The 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