---
title: "UpdateOutgoingProprietorNameRequest"
url: "https://developer.pexa.co.uk/apis/workspace-v1-v1/versions/32819e5a-6411-493b-abe8-00b7c7ca6c77/schemas/UpdateOutgoingProprietorNameRequest"
---

> Full API specification: https://developer.pexa.co.uk/apis/workspace-v1-v1/versions/32819e5a-6411-493b-abe8-00b7c7ca6c77.md

# UpdateOutgoingProprietorNameRequest

Request to update an OUTGOING role proprietor's name via orchestrated flow. This action is for proprietors that have been marked as outgoing (via SET_AS_OUTGOING_PROPRIETOR). PCS will call getProprietors to find the linked workspace party, then update the party name.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Workspace
  version: v1.3.0
servers:
  - url: https://api.pexa.co.uk
    description: API Gateway URL
components:
  schemas:
    UpdateOutgoingProprietorNameRequest:
      type: object
      required:
        - proprietorId
        - type
        - proprietorDetails
      allOf:
        - type: object
          required:
            - action
          discriminator:
            propertyName: action
            mapping:
              UPDATE_PARTY_NAME: "#/components/schemas/UpdatePartyNameRequest"
              SET_AS_INCOMING_PROPRIETOR: "#/components/schemas/SetAsIncomingProprietorRequest"
              SET_AS_OUTGOING_PROPRIETOR: "#/components/schemas/SetAsOutgoingProprietorRequest"
              UPDATE_PROPRIETOR_NAME: "#/components/schemas/UpdateProprietorNameRequest"
              UPDATE_OUTGOING_PROPRIETOR_NAME: "#/components/schemas/UpdateOutgoingProprietorNameRequest"
          properties:
            action:
              type: string
              description: |
                The type of title reconciliation action to perform.
                Allowed values: [`UPDATE_PARTY_NAME`, `SET_AS_INCOMING_PROPRIETOR`, `SET_AS_OUTGOING_PROPRIETOR`, `UPDATE_PROPRIETOR_NAME`, `UPDATE_OUTGOING_PROPRIETOR_NAME`]

                <details>
                <summary><code>UPDATE_PARTY_NAME</code></summary>

                **Required attributes**
                - `partyId`
                - `type` (`INDIVIDUAL` or `ORGANISATION`)
                - `partyDetails`

                **partyDetails by type**
                - `INDIVIDUAL`: `forenames`, `surname`
                - `ORGANISATION`: `organisationName`, `registrationNumber` (optional)

                Use schema: [`UpdatePartyNameRequest`](../schemas/UpdatePartyNameRequest)
                </details>

                <details>
                <summary><code>SET_AS_INCOMING_PROPRIETOR</code></summary>

                **Required attributes**
                - `partyId`

                Use schema: [`SetAsIncomingProprietorRequest`](../schemas/SetAsIncomingProprietorRequest)
                </details>

                <details>
                <summary><code>SET_AS_OUTGOING_PROPRIETOR</code></summary>

                **Required attributes**
                - `proprietorId`

                Use schema: [`SetAsOutgoingProprietorRequest`](../schemas/SetAsOutgoingProprietorRequest)
                </details>

                <details>
                <summary><code>UPDATE_PROPRIETOR_NAME</code></summary>

                **Required attributes**
                - `proprietorId`
                - `type` (`INDIVIDUAL` or `ORGANISATION`)
                - `proprietorDetails`

                **proprietorDetails by type**
                - `INDIVIDUAL`: `forenames`, `surname`
                - `ORGANISATION`: `organisationName`, `registrationNumber` (optional)

                Use schema: [`UpdateProprietorNameRequest`](../schemas/UpdateProprietorNameRequest)
                </details>

                <details>
                <summary><code>UPDATE_OUTGOING_PROPRIETOR_NAME</code></summary>

                **Required attributes**
                - `proprietorId`
                - `type` (`INDIVIDUAL` or `ORGANISATION`)
                - `proprietorDetails`

                **proprietorDetails by type**
                - `INDIVIDUAL`: `forenames`, `surname`
                - `ORGANISATION`: `organisationName`, `registrationNumber` (optional)

                Use schema: [`UpdateOutgoingProprietorNameRequest`](../schemas/UpdateOutgoingProprietorNameRequest)
                </details>
      description: >
        Request to update an OUTGOING role proprietor's name via orchestrated
        flow.

        This action is for proprietors that have been marked as outgoing (via
        SET_AS_OUTGOING_PROPRIETOR).

        PCS will call getProprietors to find the linked workspace party, then
        update the party name.
      properties:
        proprietorId:
          type: string
          format: uuid
          description: ID of the outgoing proprietor to update (required for this action)
          example: 987e6543-e21b-98c7-b654-321098765432
        type:
          type: string
          pattern: ^(INDIVIDUAL|ORGANISATION)$
          example: INDIVIDUAL
          description: |
            Type of party or proprietor.
            Allowed values: [`INDIVIDUAL`, `ORGANISATION`]
        proprietorDetails:
          type: object
          additionalProperties: false
          description: >
            Proprietor details for name update. Required fields depend on
            proprietor type:

            - For INDIVIDUAL: forenames (string, required), surname (string,
            required)

            - For ORGANISATION: organisationName (string, required),
            registrationNumber (string, optional)
          properties:
            forenames:
              type: string
              minLength: 1
              maxLength: 100
              description: Forenames of the individual proprietor (required for INDIVIDUAL
                type only)
              example: FN
            surname:
              type: string
              minLength: 1
              maxLength: 100
              description: Surname of the individual proprietor (required for INDIVIDUAL type
                only)
              example: LN
            organisationName:
              type: string
              minLength: 1
              maxLength: 200
              description: Name of the organisation (required for ORGANISATION type only)
              example: Pexa Ltd
            registrationNumber:
              type: string
              maxLength: 20
              description: Registration number of the organisation (optional for ORGANISATION
                type)
              example: "12345678"
```