This endpoint allows rescheduling the delivery time of an existing job. It's used when the customer or the system needs to change the delivery window, either due to customer request, delivery delays, or operational adjustments.

To perform the reschedule, the job must already exist and be identified by its job_id.

🔄 Use Cases

With capacity validation:
Use the availability endpoint to get a list of available delivery slots and select one using the returned slot_id.
Without capacity validation:
Directly provide a new from and to timestamp to set a new delivery window manually.

🧾 Request Body Examples

{
  "slot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "reason": "Customer changed preferred delivery time",
  "metadata": {
    "rescheduled_by": "customer_support_agent"
  }
}

{
  "from": "2024-09-30T16:36:37.982Z",
  "to": "2024-09-30T17:36:37.982Z",
  "reason": "Customer not available at original time",
  "metadata": {
    "rescheduled_by": "system_auto_adjustment"
  }
}

Response Codes

200 OK — Job rescheduled successfully
400 Bad Request — Invalid slot_id or missing required fields
404 Not Found — Job ID not found in the system
422 Unprocessable Entity — The provided dates or slot are not valid
500 Internal Server Error — Unexpected system error