# Benutzer aus Journeys entfernen

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

Entfernt eine Liste von Benutzern aus allen oder bestimmten aktiven Journeys.

## Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
| --- | --- | --- | --- |
| Content-Type | Ja | `application/json` | |
| Authorization | Ja | `Api <server_api_token>` | [Server API Token](/de/developer/api-reference/api-access-token/#server-api-token). |

## Anfrage-Body

| Feld | Erforderlich | Typ | Beschreibung |
| --- | --- | --- | --- |
| `user_ids` | Ja | `string[]` | Liste der [User IDs](/de/developer/api-reference/api-identifiers/#user-id), die aus Journeys entfernt werden sollen. |
| `journey_uuids` | Erforderlich, wenn `all_journeys` nicht angegeben oder `false` ist | `string[]` | Liste der [Journey IDs](/de/developer/api-reference/api-identifiers/#journey-id), aus denen Benutzer entfernt werden sollen. |
| `all_journeys` | Erforderlich, wenn `journey_uuids` nicht angegeben ist | `boolean` | Wenn `true`, werden Benutzer aus allen Journeys entfernt. Wenn `false`, muss `journey_uuids` angegeben werden. |

<Aside type="note">
Es muss mindestens eines von `all_journeys` (auf `true` gesetzt) oder `journey_uuids` (ein nicht leeres Array) angegeben werden.
</Aside>

### Anfragebeispiele

#### Benutzer aus allen Journeys entfernen

```json 
{
  "user_ids": ["user1", "user2", "user3"],
  "all_journeys": true
}
```
#### Benutzer aus bestimmten Journeys entfernen

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

### Antwortbeispiel

<Tabs>
<TabItem label="200">

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

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

Wenn die Anfrage ungültig ist, gibt die API HTTP `400` mit einer beschreibenden `message` zurück.

```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>

## Verwandte Themen

<CardGrid>
  <LinkCard title="Journey-Statistiken abrufen" href="/developer/api-reference/customer-journey-api/statistics/" />
  <LinkCard title="Per API starten" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="Lebenszyklus" href="/developer/api-reference/customer-journey-api/lifecycle/" />
</CardGrid>