# إزالة المستخدمين من رحلات العملاء

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

يزيل قائمة من المستخدمين من جميع رحلات العملاء النشطة أو من رحلات محددة.

## ترويسات الطلب

| الاسم | مطلوب | القيمة | الوصف |
| --- | --- | --- | --- |
| Content-Type | نعم | `application/json` | |
| Authorization | نعم | `Api <server_api_token>` | [رمز Server API](/ar/developer/api-reference/api-access-token/#server-api-token). |

## نص الطلب

| الحقل | مطلوب | النوع | الوصف |
| --- | --- | --- | --- |
| `user_ids` | نعم | `string[]` | قائمة من [معرفات المستخدم (User IDs)](/ar/developer/api-reference/api-identifiers/#user-id) لإزالتها من رحلات العملاء. |
| `journey_uuids` | مطلوب إذا لم يتم توفير `all_journeys` أو كانت قيمته `false` | `string[]` | قائمة من [معرفات رحلات العملاء (Journey IDs)](/ar/developer/api-reference/api-identifiers/#journey-id) لإزالة المستخدمين منها. |
| `all_journeys` | مطلوب إذا لم يتم توفير `journey_uuids` | `boolean` | إذا كانت القيمة `true`، يتم إزالة المستخدمين من جميع رحلات العملاء. إذا كانت `false`، يجب توفير `journey_uuids`. |

<Aside type="note">
يجب توفير واحد على الأقل من `all_journeys` (مع القيمة `true`) أو `journey_uuids` (كمصفوفة غير فارغة).
</Aside>

### أمثلة على الطلبات

#### إزالة المستخدمين من جميع رحلات العملاء

```json 
{
  "user_ids": ["user1", "user2", "user3"],
  "all_journeys": true
}
```
#### إزالة المستخدمين من رحلات عملاء محددة

```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="الحصول على إحصائيات رحلة العميل" 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>