---
title: "SetAsIncomingProprietorRequest"
url: "https://developer.pexa.co.uk/apis/workspace-v1-v1/versions/f42817f3-815f-4a74-8ba5-2f83efd8ab42/schemas/SetAsIncomingProprietorRequest"
---

> Full API specification: https://developer.pexa.co.uk/apis/workspace-v1-v1/versions/f42817f3-815f-4a74-8ba5-2f83efd8ab42.md

# SetAsIncomingProprietorRequest

Request to mark a party as an incoming proprietor. Only requires partyId. Only INDIVIDUAL parties are supported.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Workspace
  version: v1
servers:
  - url: https://api.pexa.co.uk
    description: API Gateway URL
components:
  schemas:
    SetAsIncomingProprietorRequest:
      type: object
      description: |
        Request to mark a party as an incoming proprietor.
        Only requires partyId. Only INDIVIDUAL parties are supported.
      required:
        - partyId
      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>
      properties:
        partyId:
          type: string
          format: uuid
          description: ID of the party to mark as incoming proprietor (required for this
            action)
          example: 123e4567-e89b-12d3-a456-426614174000
```