Skip to main content
Routal

Update a task

Updates a task on a stop — its label, comments, barcode, customfields or status.

PUT
/v2/task/{task_id}

Updates a task on a stop — its label, comments, barcode, custom_fields or status. Useful for correcting task data before execution, or for resetting a task back to pending if the driver checked it off by mistake.

Authorization

api_key
private_key<token>

The Routal API authenticates requests with an API key passed as the private_key query string parameter. Generate and rotate your keys from the Developer Settings section of your Routal workspace.Never ship API keys to a browser or mobile app — they must stay server-side.

In: query

Path Parameters

task_id*string

Task ID

Match^[0-9a-f]{24}

Query Parameters

stop_id*string

Stop ID

Match^[0-9a-f]{24}

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v2/task/string?stop_id=string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "4f75d991ac359f8c4c79d762",
  "stop_id": "4f75d991ac359f8c4c79d762",
  "label": "Deliver refrigerated parcel 1/2",
  "comments": "Keep cold chain. Weight 12.4 kg.",
  "barcode": "8410076472158",
  "status": "completed",
  "custom_fields": {
    "sku": "SKU-4582",
    "quantity": 2,
    "lot_number": "L-2026-038"
  },
  "created_by": "4f75d991ac359f8c4c79d762",
  "created_at": "2026-05-29T14:55:24.485Z",
  "updated_at": "2026-05-29T14:55:24.485Z",
  "deleted_at": "2026-05-29T14:55:24.485Z"
}
{
  "message": "Domain not found",
  "message_id": "highway.domain.error.not_found"
}
Empty
{
  "message": "Domain not found",
  "message_id": "highway.domain.error.not_found"
}
{
  "message": "Domain not found",
  "message_id": "highway.domain.error.not_found"
}
Empty
Empty