# DELETE /v2/charter

# Charter: Delete (Soft Deactivate)

این اندپوینت مسئول حذف نرم (Soft Delete) یا غیرفعال‌سازی یک چارتر است. توجه داشته باشید که این متد رکورد را از دیتابیس **پاک نمی‌کند**، بلکه وضعیت (Status) آن را به مقدار `2` تغییر می‌دهد (که معمولاً به معنای غیرفعال یا بایگانی است).

<div class="api-docs" id="bkmrk-"></div>## Request Overview

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fcharter-met"><div class="endpoint-info"><div>**URL:** `/v2/charter`</div><div>**Method:** <span class="method-delete">DELETE</span></div><div>**Controller:** CharterController@deleteCharter</div><div>**Middleware Stack:** authWithJwt</div></div></div>## Access Control

<div class="api-docs" id="bkmrk-%D8%AF%D8%B3%D8%AA%D8%B1%D8%B3%DB%8C-%D9%85%D8%B9%D8%AA%D8%A8%D8%B1-jwt">- دسترسی معتبر JWT

</div>## Request Parameters

<div class="api-docs" id="bkmrk-field-type-required-"><table class="schema-table" dir="rtl"><thead><tr><th>Field</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>yes</td><td>شناسه چارتری که باید غیرفعال شود</td></tr></tbody></table>

</div>## Logic Details

<div class="api-docs" id="bkmrk-%D8%B9%D9%85%D9%84%DB%8C%D8%A7%D8%AA-%D9%85%D8%B3%D8%AA%D9%82%DB%8C%D9%85-%D8%AF%DB%8C%D8%AA%D8%A7%D8%A8%DB%8C">- **عملیات مستقیم دیتابیس:** این متد از Eloquent Model استفاده نمی‌کند و مستقیماً روی جدول `charters` کوئری آپدیت می‌زند.
- **تغییر وضعیت:** مقدار فیلد `status` برای رکورد مورد نظر به عدد `2` تغییر می‌یابد.
- **مدیریت خطا:** کلیه عملیات داخل بلوک `try-catch` قرار دارد. در صورت بروز خطا (مثلاً مشکل دیتابیس)، متن خطا و Trace برگردانده می‌شود.

</div>## Response (Success)

```
{
  "status": true,
  "time": 1710000000
}
  
```

<div class="api-docs" id="bkmrk--1"></div>## Response (Exception Error)

```
{
  "status": false,
  "time": 1710000000,
  "message": "SQLSTATE[...]: Integrity constraint violation...",
  "trace": [...]
}
  
```

<div class="api-docs" id="bkmrk--2"></div>## Flowchart

<div class="api-docs" id="bkmrk-start-%28delete-%2Fv2%2Fch"><div class="flowchart"><div class="flow-item">Start (DELETE /v2/charter)</div><div class="flow-arrow">↓</div><div class="flow-item">Get Request ID</div><div class="flow-arrow">↓</div><div class="flow-item">DB Transaction: Update `charters` SET `status` = 2</div><div class="flow-arrow">↓</div><div style="display: flex; justify-content: center; gap: 20px;"><div style="display: flex; flex-direction: column; align-items: center;"><div class="flow-item" style="border-color: green;">Success</div><div class="flow-arrow">↓</div><div class="flow-item">Return { status: true }</div></div><div style="display: flex; flex-direction: column; align-items: center;"><div class="flow-item" style="border-color: red;">Exception</div><div class="flow-arrow">↓</div><div class="flow-item">Return { status: false, message... }</div></div></div></div></div>