# Удаление пользователей из Journey

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

Удаляет список пользователей из всех или определенных активных Journey.

## Заголовки запроса

| Название | Обязательно | Значение | Описание |
| --- | --- | --- | --- |
| Content-Type | Да | `application/json` | |
| Authorization | Да | `Api <server_api_token>` | [Server API token](/ru/developer/api-reference/api-access-token/#server-api-token). |

## Тело запроса

| Поле | Обязательно | Тип | Описание |
| --- | --- | --- | --- |
| `user_ids` | Да | `string[]` | Список [User ID](/ru/developer/api-reference/api-identifiers/#user-id) для удаления из Journey. |
| `journey_uuids` | Обязательно, если `all_journeys` не предоставлен или равен `false` | `string[]` | Список [Journey ID](/ru/developer/api-reference/api-identifiers/#journey-id), из которых нужно удалить пользователей. |
| `all_journeys` | Обязательно, если `journey_uuids` не предоставлен | `boolean` | Если `true`, пользователи удаляются из всех Journey. Если `false`, необходимо предоставить `journey_uuids`. |

<Aside type="note">
Необходимо предоставить хотя бы один из параметров: `all_journeys` (со значением `true`) или `journey_uuids` (непустой массив).
</Aside>

### Примеры запросов

#### Удаление пользователей из всех Journey

```json 
{
  "user_ids": ["user1", "user2", "user3"],
  "all_journeys": true
}
```
#### Удаление пользователей из определенных Journey

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

### Пример ответа

<Tabs>
<TabItem label="200">

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

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

Если запрос недействителен, API возвращает HTTP `400` с описательным `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>

## Связанные статьи

<CardGrid>
  <LinkCard title="Получить статистику Journey" href="/developer/api-reference/customer-journey-api/statistics/" />
  <LinkCard title="Запуск через API" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="Жизненный цикл" href="/developer/api-reference/customer-journey-api/lifecycle/" />
</CardGrid>