# st.removeConnection

This action allows you to remove a person from your connections.

> If you need to remove several people from your connections, use this action multiple times within an [array workflow](/docs/building-workflows). This approach is significantly faster than creating separate workflows for each person due to API optimizations.

## Constraints

> ⏺️ **Root Start:** allowed, when `personUrl` parameter is provided.

> ⬆️ **Parent Actions:** [st.openPersonPage](/docs/action-st-open-person-page).

> ⬇️ **Child Actions:** N/A.

## Parameters

```json
{
  "actionType": "st.removeConnection",
  "label": "remove1",
  "personUrl": "https://www.linkedin.com/in/person1"
}
```

- `label` (optional) – custom label for tracking this action in workflow completion.
- `personUrl` (required for root start, forbidden for parent start) – [public or hashed](/faq/what-are-hashed-url-and-public-url) LinkedIn URL of the person you want to remove from your connections.

## Result options

1. **Successful connection removal:**

```json
{
  "actionType": "st.removeConnection",
  "label": "remove1",
  "success": true
}
```

- `label` – included only if specified in the action parameters.

2. **Failed connection removal:**

```json
{
  "actionType": "st.removeConnection",
  "label": "remove1",
  "success": false,
  "error": {
    "type": "connectionNotFound",
    "message": "This person is not in your connections."
  }
}
```

- `label` – included only if specified in the action parameters.
- `error.type` – enum with the following possible values:
  - `personNotFound` – provided URL is not an existing LinkedIn person.
  - `connectionNotFound` – person is not in your connections.