Reschedule a Job

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