# Journey에서 사용자 제거

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

모든 또는 특정 활성 Journey에서 사용자 목록을 제거합니다.

## 요청 헤더

| 이름 | 필수 | 값 | 설명 |
| --- | --- | --- | --- |
| Content-Type | 예 | `application/json` | |
| Authorization | 예 | `Api <server_api_token>` | [서버 API 토큰](/ko/developer/api-reference/api-access-token/#server-api-token)입니다. |

## 요청 본문

| 필드 | 필수 | 타입 | 설명 |
| --- | --- | --- | --- |
| `user_ids` | 예 | `string[]` | Journey에서 제거할 [User ID](/ko/developer/api-reference/api-identifiers/#user-id) 목록입니다. |
| `journey_uuids` | `all_journeys`가 제공되지 않거나 `false`인 경우 필수 | `string[]` | 사용자를 제거할 [Journey ID](/ko/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는 설명 `message`와 함께 HTTP `400`을 반환합니다.

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