Patch Supplier
Edit identity fields on the registry row.
Each field on the PATCH body is optional; omitted fields keep
their current value, and explicit null clears a nullable field.
name cannot be cleared (it's required).
โถOutcomes
The PATCH may take one of four code paths depending on how many
organizations link to the supplier and whether the new identity
collides with another row's fingerprint. Branch on
meta.outcome:
outcome | When | Effect |
|---|---|---|
in_place | Only your organization links to the supplier. | The global row is updated. data.id is unchanged. |
fork | Multiple organizations link; the new fingerprint does NOT collide. | A new global row is minted with the edited identity; your link is repointed; other orgs continue to see the original row. data.id is the new id. |
fork_into_existing | Multiple organizations link AND the new fingerprint collides with an existing global row. | Your link repoints to the collider; no new row minted. data.id is the collider's id. |
merge | Only your organization links AND the new fingerprint collides. | Your link repoints to the collider; the original row is soft-deleted. data.id is the collider's id. |
Always trust data.id for "where your link points now" โ it may
differ from the request's :id after a fork or merge.
โถPropagation to pending DDS records
Every pending DDS version of your organization that references this supplier is updated:
- Its
dds_record_version_shed.supplier_idis repointed when the outcome isfork/fork_into_existing/merge. - One
supplier.propagatedevent is appended per affected version (withpropagated_via: "live_link"). - On
fork/fork_into_existingasupplier.forkedevent is additionally appended; onmerge, asupplier.mergedevent.
Affected version ids are listed in meta.affected_dds_version_ids.
Frozen DDS versions (already submitted, or older versions that have been frozen by a subsequent version cut) are not affected โ they keep their snapshot identity.
โถErrors
400โ invalid country code, oversize field, unknown key, or a duplicateexternal_idfor your organization.404โ supplier not linked to your organization.
Required scope:
parties:write