Set Company Representation Decision

PATCH 
/api/partner/v1/onboarding/:ref/representation

Records whether the person creating the account is a representative of a multi-person company and derives the representation mode from the company's registered governing body. Applies to multi-person companies only (422 for sole traders / natural persons). The response includes representation_mode (solo, co_representative or proxy) and requires_invitation_or_poa; non-solo modes require inviting the other person and/or uploading a power of attorney. Requires scope onboarding:write.

Request

Responses

200

Decision saved. Returns the draft reference plus the resolved representation mode.

401

Missing, invalid or revoked partner key.

403

Partner key lacks the onboarding:write scope.

404

Unknown ref within your channels.

409

Account already active - onboarding data is no longer editable.

422

Validation failed, or this segment does not apply to the entity type (sole trader / natural person).