> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Associated Person

> Remove a beneficial owner, director or control person that no provider has been told about yet

Deletes one associated person. The delete is a soft delete: the record is retained for audit and for any documents already attached to it, but the person stops being returned by any client endpoint and is left out of every future provider submission.

Requires an API key with `write` access on the `accounts` scope. Like creation, this endpoint works only on **business** accounts, and the account holder cannot be removed.

Deleting re-triggers virtual account group onboarding, so a requirement that was waiting on this person's details is withdrawn on the next sync instead of staying open.

## Path Parameters

<ParamField path="account_id" type="string" required>
  The account's external ID (starts with `acct_`)
</ParamField>

<ParamField path="person_id" type="string" required>
  The associated person's external ID (starts with `aap_`). One belonging to another account returns `404`.
</ParamField>

## Response

<ResponseField name="id" type="string">
  The associated person identifier that was deleted
</ResponseField>

<ResponseField name="object" type="string">
  Always returns `"associated_person"`
</ResponseField>

<ResponseField name="deleted" type="boolean">
  Always returns `true`
</ResponseField>

## Errors

| Status | `code` | When |
| - | - | - |
| `404` | `RESOURCE_NOT_FOUND` | No such person, it belongs to another account, or it was already deleted: deleting the same id twice returns `404`, not `deleted: true` |
| `422` | `DELETE_BLOCKED` | The person has been submitted to a provider or has signed an agreement; `details.person_id` names the person |
| `422` | `BUSINESS_RULE_VIOLATION` | The person is the account holder, or the account is not a business account |

## Response Example

```json theme={null}
{
  "id": "aap_7k2m9x1q4v8b3n6c5d0f2h4j",
  "object": "associated_person",
  "deleted": true
}
```