Skip to main content
Use one of the following inputs to remove an existing stakeholder:
  • removePersonStakeholderInput
  • removeBusinessStakeholderInput
You only need to provide the stakeholder’s id to remove them.
After reviewing his application, Ben realizes that he mistakenly added his former business partner who is no longer involved with the company. He needs to remove this stakeholder from the application before proceeding with the underwriting process.
For example, all applicants are required to identify a control person. Removing required stakeholders will cause validation to fail when you submit the application.
mutation UpdateAcceptorApplication($input: AcceptorApplicationUpdateInput!) {
  updateAcceptorApplication(input: $input) {
    acceptorApplication {
      applicationStatus
      stakeholders {
        id
        ownershipPercentage
        ... on BusinessStakeholderOutput {
          businessName
        }
        ... on PersonStakeholderOutput {
          name {
            firstName
            lastName
          }
        }
      }
    }
    errors {
      ... on Error {
        message
        __typename
      }
    }
  }
}

{
  "data": {
    "updateAcceptorApplication": {
      "acceptorApplication": {
        "id": "60c66576-0caf-4dd1-8c66-fccae049f0fd",
        "applicationStatus": "CREATED",
        "stakeholders": []
      }
    }
  }
}
One of the benefits of GraphQL is that you can perform multiple stakeholder operations in a single API call. For example, you can add new stakeholders, update existing ones, and remove others all in the same updateAcceptorApplication mutation.