Self-assign order

PATCH {{baseUrl}}/orders/{{orderId}}/assign?confirm=true

Self-assigns an order to the driver. Source: modules/transactions/…/assignOrderController.ts.

Response fields:

• data — the updated order/transaction row (id, status now in_progress, runner_id, runner_assigned_at, plus order/customer details).
• message — literally the string "Order assgined" returned by the backend. That’s a real typo in the source, not a mistake in this doc.

Request body

{
  "runnerId": "{{userId}}"
}

Examples

cURL

curl --request PATCH 'https://api.firstdelivery.com/api/orders/REPLACE_WITH_ORDER_ID/assign?confirm=true' \
  --header 'Content-Type: application/json' \
  --data '{
  "runnerId": "{{userId}}"
}'

Node.js

const response = await fetch("https://api.firstdelivery.com/api/orders/REPLACE_WITH_ORDER_ID/assign?confirm=true", {
  "method": "PATCH",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": "{\n  \"runnerId\": \"{{userId}}\"\n}"
})
const data = await response.json()

Python

import requests

response = requests.request(
    "PATCH",
    "https://api.firstdelivery.com/api/orders/REPLACE_WITH_ORDER_ID/assign?confirm=true",
    headers={
  'Content-Type': 'application/json'
},
    data="{\n  \"runnerId\": \"{{userId}}\"\n}",
)
response.raise_for_status()

Saved responses

200 200 OK

{
  "data": {
    "id": "REPLACE_WITH_ORDER_ID",
    "status": "in_progress",
    "runner_id": "8e17d5db-da6e-453c-966f-bfc72c125094",
    "runner_assigned_at": "2026-06-22T14:05:00.000Z",
    "company_name": "Tony's Pizza",
    "delivery_address": "456 Oak Ave",
    "order_number": 4821
  },
  "message": "Order assgined"
}