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

FieldTypeDescription
namestringOrganisation name (1โ€“255 characters)
operator_namestring | nullOperator legal name (1โ€“200 chars)
operator_address_streetstring | nullOperator address โ€” street
operator_address_postal_codestring | nullOperator address โ€” postal code
operator_address_citystring | nullOperator address โ€” city
operator_address_fullstring | nullOperator address โ€” single-line fallback (optional)
operator_countrystring | nullISO 3166-1 alpha-2 country code (e.g. GB)
operator_emailstring | nullOperator contact email (RFC 5321; โ‰ค 320 chars)
operator_eoristring | nullEORI number: 2-letter country code + up to 15 alphanumeric chars (e.g. XI274615093000)
operator_identifier_type"EORI" | "VAT" | nullIdentifier scheme for the EORI/VAT value
operator_phonestring | nullE.164 phone number (e.g. +441234567890)
default_activity_type"DOMESTIC" | "IMPORT" | "EXPORT" | nullDefault EUDR activity type for new DDS records
default_country_of_activitystring | nullDefault country of activity for IMPORT/EXPORT โ€” EU-27 or XI only
default_geo_location_confidentialboolean | nullDefault 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