# ลบผู้ใช้ออกจาก Journey

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

ลบรายชื่อผู้ใช้ออกจาก Journey ที่ใช้งานอยู่ทั้งหมดหรือเฉพาะเจาะจง

## Request headers

| ชื่อ | จำเป็น | ค่า | คำอธิบาย |
| --- | --- | --- | --- |
| Content-Type | ใช่ | `application/json` | |
| Authorization | ใช่ | `Api <server_api_token>` | [Server API token](/th/developer/api-reference/api-access-token/#server-api-token) |

## Request body

| ฟิลด์ | จำเป็น | ประเภท | คำอธิบาย |
| --- | --- | --- | --- |
| `user_ids` | ใช่ | `string[]` | รายการ [User ID](/th/developer/api-reference/api-identifiers/#user-id) ที่จะลบออกจาก Journey |
| `journey_uuids` | จำเป็นหากไม่ได้ระบุ `all_journeys` หรือเป็น `false` | `string[]` | รายการ [Journey ID](/th/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>

### ตัวอย่าง Request

#### ลบผู้ใช้ออกจาก Journey ทั้งหมด

```json 
{
  "user_ids": ["user1", "user2", "user3"],
  "all_journeys": true
}
```
#### ลบผู้ใช้ออกจาก Journey ที่เฉพาะเจาะจง

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

### ตัวอย่าง Response

<Tabs>
<TabItem label="200">

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

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

หาก request ไม่ถูกต้อง 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="Lifecycle" href="/developer/api-reference/customer-journey-api/lifecycle/" />
</CardGrid>