Error Handling & Retries
Shipdesk returns standard HTTP response codes alongside the unified Shipdesk error envelope.Error Envelope Reference
HTTP Status Codes
Retrying Transient Failures
- Safe to retry (Idempotent): All
GETrequests,POST /v1/rates,POST /v1/serviceability. - Never blindly retry:
POST /v1/orders/:id/assign. Writes to couriers can create duplicate AWBs if retried blindly. If an assignment call times out, callGET /v1/orders/:idfirst to inspect if an AWB was already claimed before attempting reassignment.