Skip to main content
POST
Advance a sandbox delivery

Authorizations

Authorization
string
header
required

A business-bound HaulStow API key. Send Authorization: Bearer hsg_live_key_... to the live server or a hsg_test_key_... key to the sandbox server. Never expose this key in a browser.

Headers

X-Request-ID
string

Optional caller correlation ID. Use 1–128 ASCII letters, digits, ., _, -, or :. Invalid values are replaced. The accepted/generated value is returned in the response.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]+$
Idempotency-Key
string
required

A unique key for this logical mutation. Retained for 24 hours.

Required string length: 8 - 255

Path Parameters

delivery_id
string
required
Pattern: ^dlv_[a-f0-9]{32}$
Example:

"dlv_3f1a821cdb58498cbb52f4706545a089"

Body

application/json
status
enum<string>
required
Available options:
assigned,
picked_up,
in_transit,
delivered,
failed,
cancelled

Response

Sandbox delivery advanced.

success
boolean
required
statusCode
enum<integer>
required
Available options:
200,
201
message
string
required
data
object
required