# Remove users from journeys

`POST` `https://journey.pushwoosh.com/api/journey/drop-users/external`

Removes a list of users from all or specific active journeys.

## Request headers

| Name | Required | Value | Description |
| --- | --- | --- | --- |
| Content-Type | Yes | `application/json` | |
| Authorization | Yes | `Api <server_api_token>` | [Server API token](/developer/api-reference/api-access-token/#server-api-token). |

## Request body

| Field | Required | Type | Description |
| --- | --- | --- | --- |
| `user_ids` | Yes | `string[]` | List of [User IDs](/developer/api-reference/api-identifiers/#user-id) to remove from journeys. |
| `journey_uuids` | Required if `all_journeys` is not provided or `false` | `string[]` | List of [Journey IDs](/developer/api-reference/api-identifiers/#journey-id) to remove users from. |
| `all_journeys` | Required if `journey_uuids` is not provided | `boolean` | If `true`, users are removed from all journeys. If `false`, `journey_uuids` must be provided. |

<Aside type="note">
At least one of `all_journeys` (set to `true`) or `journey_uuids` (non-empty array) must be provided.
</Aside>

### Request examples

#### Remove users from all journeys

```json 
{
  "user_ids": ["user1", "user2", "user3"],
  "all_journeys": true
}
```
#### Remove users from specific journeys

```json 
{
  "user_ids": ["user1", "user2"],
  "journey_uuids": ["journey-uuid-1", "journey-uuid-2"]
}
```

### Response example

<Tabs>
<TabItem label="200">

```json
{
  "success": true
}
```

</TabItem>
<TabItem label="400">

If the request is invalid, the API returns HTTP `400` with a descriptive `message`.

```json
{
  "success": false,
  "message": "user_ids must be provided"
}
```

```json
{
  "success": false,
  "message": "journey_uuids must be provided if all_journeys is false"
}
```

</TabItem>
</Tabs>

## Related

<CardGrid>
  <LinkCard title="Get Journey stats" href="/developer/api-reference/customer-journey-api/statistics/" />
  <LinkCard title="Start by API" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="Lifecycle" href="/developer/api-reference/customer-journey-api/lifecycle/" />
</CardGrid>