# Remover usuários de jornadas

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

Remove uma lista de usuários de todas ou de jornadas ativas específicas.

## Cabeçalhos da solicitação

| Nome | Obrigatório | Valor | Descrição |
| --- | --- | --- | --- |
| Content-Type | Sim | `application/json` | |
| Authorization | Sim | `Api <server_api_token>` | [Token da API do servidor](/pt/developer/api-reference/api-access-token/#server-api-token). |

## Corpo da solicitação

| Campo | Obrigatório | Tipo | Descrição |
| --- | --- | --- | --- |
| `user_ids` | Sim | `string[]` | Lista de [IDs de Usuário](/pt/developer/api-reference/api-identifiers/#user-id) para remover das jornadas. |
| `journey_uuids` | Obrigatório se `all_journeys` não for fornecido ou for `false` | `string[]` | Lista de [IDs de Jornada](/pt/developer/api-reference/api-identifiers/#journey-id) das quais os usuários serão removidos. |
| `all_journeys` | Obrigatório se `journey_uuids` não for fornecido | `boolean` | Se `true`, os usuários são removidos de todas as jornadas. Se `false`, `journey_uuids` deve ser fornecido. |

<Aside type="note">
Pelo menos um dos campos, `all_journeys` (definido como `true`) ou `journey_uuids` (um array não vazio), deve ser fornecido.
</Aside>

### Exemplos de solicitação

#### Remover usuários de todas as jornadas

```json 
{
  "user_ids": ["user1", "user2", "user3"],
  "all_journeys": true
}
```
#### Remover usuários de jornadas específicas

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

### Exemplo de resposta

<Tabs>
<TabItem label="200">

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

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

Se a solicitação for inválida, a API retorna HTTP `400` com uma `message` descritiva.

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

## Relacionados

<CardGrid>
  <LinkCard title="Obter estatísticas da Jornada" href="/developer/api-reference/customer-journey-api/statistics/" />
  <LinkCard title="Iniciar via API" href="/developer/api-reference/customer-journey-api/start-by-api/" />
  <LinkCard title="Ciclo de vida" href="/developer/api-reference/customer-journey-api/lifecycle/" />
</CardGrid>