API reference corrections across twenty specs
Corrected reference pages that did not match live API behavior. The APIs are unchanged; the pages now match what the endpoints accept and return.
- Response shapes: the four Channel Metafield operations documented the wrong body. They now match the
{ data, meta }response the gateway returns. Get Deployment Event Stream and Tail Worker Logs now show a field table per event. - Error responses: Create Site, Update Site, Delete Multiple Metafields, Update Redirects, and the shipping customs-information operations now document the
422they return. Shipping also documents400and413. - Requests: Create Site documents the optional
certificateobject, Update Email Template documents the three fields it actually reads, List Subscribers documentssortanddirection, and shipping rate requests documentrate_options. - Types, headers, and scopes:
site_idandchannel_idare integers, not strings. Tax customer endpoints requireAccept, notContent-Type. Promotion Settings requiresstore_v2_information, notstore_v2_marketing.
If you built against any of these pages, recheck your request and response handling: