v1

latestOpenAPI 3.1.02026-07-2296226496.3 KB

Job

Reassign task by Job ID and Task ID

Cancel the current delivery attempt and create a new task for reassignment. A new task is created on the same job configuration, allowing a different provider to fulfill the delivery.

post/v1/jobs/{jobId}/{taskId}/reassign

Path parameters

jobIdstring required

job id

taskIdstring required

task id

Request body

pickupStartTimestring nullable

New pickup start time

pickupEndTimestring nullable

New pickup end time

dropoffStartTimestring nullable

New dropoff start time

dropoffEndTimestring nullable

New dropoff end time

deliveryMode'now' | 'scheduled' nullable

New package delivery mode.

Example request

{
  "pickupStartTime": "2021-01-01T00:00:00Z",
  "pickupEndTime": "2021-01-01T00:15:00Z",
  "dropoffStartTime": "2021-01-01T00:30:00Z",
  "dropoffEndTime": "2021-01-01T01:00:00Z",
  "deliveryMode": "now"
}

Response

idstring required

Job ID

createdAtstring required

Created at

portalUrlstring required

Portal URL

externalIdentifierstring nullable

External identifier

jobMetadataobject nullable

Job metadata

isActiveboolean required

Is the job active

isBatchboolean required

Is the job a batch

shortReferenceCodestring nullable

7-digit non-unique human-readable reference code for the job.

selectedConfigurationobject nullable

Selected configuration

jobSpecificationobject nullable

Job specification