Update Child
Update a child organisation's attributes.
All fields are optional โ only the fields included in the request body will be updated. The response returns the full updated organisation resource.
โถUpdatable attributes
| Field | Type | Description |
|---|---|---|
name | string | Organisation name (1โ255 characters) |
operator_name | string | null | Operator legal name (1โ200 chars) |
operator_address_street | string | null | Operator address โ street |
operator_address_postal_code | string | null | Operator address โ postal code |
operator_address_city | string | null | Operator address โ city |
operator_address_full | string | null | Operator address โ single-line fallback (optional) |
operator_country | string | null | ISO 3166-1 alpha-2 country code (e.g. GB) |
operator_email | string | null | Operator contact email (RFC 5321; โค 320 chars) |
operator_eori | string | null | EORI number: 2-letter country code + up to 15 alphanumeric chars (e.g. XI274615093000) |
operator_identifier_type | "EORI" | "VAT" | null | Identifier scheme for the EORI/VAT value |
operator_phone | string | null | E.164 phone number (e.g. +441234567890) |
default_activity_type | "DOMESTIC" | "IMPORT" | "EXPORT" | null | Default EUDR activity type for new DDS records |
default_country_of_activity | string | null | Default country of activity for IMPORT/EXPORT โ EU-27 or XI only |
default_geo_location_confidential | boolean | null | Default geo-location confidentiality flag for new DDS records |
The three default_* fields are the org-level EUDR submission defaults. Two
combinations are refused with 422: DOMESTIC together with a
default_country_of_activity, and an activity default the organisation's own
operator could never file under (IMPORT/EXPORT with a VAT-identified
operator, or any non-IMPORT value with a non-EU operator_country). The
DOMESTIC rule applies whenever the request includes
default_activity_type or default_country_of_activity โ sending a DOMESTIC
value with no country clears any stored default_country_of_activity. The
GAP-25/26 rules apply only when the request changes
default_activity_type, operator_identifier_type or operator_country, so a
pre-existing bad combination does not block an unrelated write. See PATCH /organizations/me for the full rules.
Exception โ read-modify-write stays idempotent. When the stored profile
already holds DOMESTIC beside a default_country_of_activity (only
reachable from a writer outside this API), re-sending that same country while
the profile stays DOMESTIC is treated as a no-op repair: the request
succeeds and the stored country is cleared, rather than failing on every
retry. A request that also moves the activity type to IMPORT/EXPORT keeps
the country, because the pair is then consistent; the GAP-25/26 rules above
still apply to the new activity type.
The response includes read-only fields plan, tier, and domain which cannot be modified through this endpoint.
Required scope:
organizations:write