[{"data":1,"prerenderedAt":261},["ShallowReactive",2],{"route-doc-meta:\u002Freference\u002Fdeprecations":3,"page-dates:\u002Freference\u002Fdeprecations":163,"reference-\u002Freference\u002Fdeprecations":166},{"id":4,"title":5,"body":6,"description":155,"extension":156,"meta":157,"navigation":158,"path":159,"seo":160,"stem":161,"__hash__":162},"content\u002Freference\u002Fdeprecations.md","Deprecations",{"type":7,"value":8,"toc":149},"minimark",[9,13,17,22,25,111,123,127,143],[10,11,5],"h1",{"id":12},"deprecations",[14,15,16],"p",{},"The API signals deprecations in machine-readable ways so that your code — and AI agents building against the API — can detect them automatically, rather than relying on you to read a changelog.",[18,19,21],"h2",{"id":20},"response-headers","Response headers",[14,23,24],{},"When you call a deprecated endpoint, the response carries standard deprecation headers:",[26,27,28,44],"table",{},[29,30,31],"thead",{},[32,33,34,38,41],"tr",{},[35,36,37],"th",{},"Header",[35,39,40],{},"Standard",[35,42,43],{},"Description",[45,46,47,73,90],"tbody",{},[32,48,49,56,66],{},[50,51,52],"td",{},[53,54,55],"code",{},"Deprecation",[50,57,58],{},[59,60,65],"a",{"href":61,":target":62,"rel":63},"https:\u002F\u002Fwww.rfc-editor.org\u002Frfc\u002Frfc9745","\\_blank",[64],"nofollow","RFC 9745",[50,67,68,69,72],{},"Present with the value ",[53,70,71],{},"true"," when the endpoint is deprecated.",[32,74,75,80,87],{},[50,76,77],{},[53,78,79],{},"Sunset",[50,81,82],{},[59,83,86],{"href":84,":target":62,"rel":85},"https:\u002F\u002Fwww.rfc-editor.org\u002Frfc\u002Frfc8594",[64],"RFC 8594",[50,88,89],{},"An HTTP date after which the endpoint may stop responding. Present only when a date has been set.",[32,91,92,97,100],{},[50,93,94],{},[53,95,96],{},"Link",[50,98,99],{},"—",[50,101,102,103,106,107,110],{},"A link to the replacement, with ",[53,104,105],{},"rel=\"successor-version\"",", e.g. ",[53,108,109],{},"Link: \u003C\u002Faccounting\u002F{connection_id}\u002Fsalesorder>; rel=\"successor-version\"",".",[14,112,113,114,116,117,119,120,122],{},"Watch for the ",[53,115,55],{}," header in your responses and migrate to the resource named by the ",[53,118,96],{}," successor before the ",[53,121,79],{}," date, if one is given.",[18,124,126],{"id":125},"specification-flags","Specification flags",[14,128,129,130,134,135,138,139,142],{},"Deprecated operations and fields are also marked in our ",[59,131,133],{"href":132},"\u002Freference\u002Fsdks","OpenAPI and Swagger specifications"," with the standard ",[53,136,137],{},"deprecated: true"," flag. Code generators (including the ones that build our ",[59,140,141],{"href":132},"SDKs",") surface these as deprecation warnings, so deprecated fields and methods are flagged in your editor at build time.",[14,144,145,146,148],{},"Avoid deprecated operations and fields in new code, and prefer the successor the specification or the ",[53,147,96],{}," header points to.",{"title":150,"searchDepth":151,"depth":151,"links":152},"",2,[153,154],{"id":20,"depth":151,"text":21},{"id":125,"depth":151,"text":126},"How the API signals deprecated endpoints and fields","md",{},true,"\u002Freference\u002Fdeprecations",{"title":5,"description":155},"reference\u002Fdeprecations","pW31LRPbTFkDusQX-x_YXp2vw9A38LCM7gkq_YcSpvk",{"updatedAt":164,"author":165},"2026-10-16T18:18:45.000Z","Roy Pereira",{"id":4,"title":5,"body":167,"description":155,"extension":156,"meta":259,"navigation":158,"path":159,"seo":260,"stem":161,"__hash__":162},{"type":7,"value":168,"toc":255},[169,171,173,175,177,233,241,243,251],[10,170,5],{"id":12},[14,172,16],{},[18,174,21],{"id":20},[14,176,24],{},[26,178,179,189],{},[29,180,181],{},[32,182,183,185,187],{},[35,184,37],{},[35,186,40],{},[35,188,43],{},[45,190,191,206,219],{},[32,192,193,197,202],{},[50,194,195],{},[53,196,55],{},[50,198,199],{},[59,200,65],{"href":61,":target":62,"rel":201},[64],[50,203,68,204,72],{},[53,205,71],{},[32,207,208,212,217],{},[50,209,210],{},[53,211,79],{},[50,213,214],{},[59,215,86],{"href":84,":target":62,"rel":216},[64],[50,218,89],{},[32,220,221,225,227],{},[50,222,223],{},[53,224,96],{},[50,226,99],{},[50,228,102,229,106,231,110],{},[53,230,105],{},[53,232,109],{},[14,234,113,235,116,237,119,239,122],{},[53,236,55],{},[53,238,96],{},[53,240,79],{},[18,242,126],{"id":125},[14,244,129,245,134,247,138,249,142],{},[59,246,133],{"href":132},[53,248,137],{},[59,250,141],{"href":132},[14,252,145,253,148],{},[53,254,96],{},{"title":150,"searchDepth":151,"depth":151,"links":256},[257,258],{"id":20,"depth":151,"text":21},{"id":125,"depth":151,"text":126},{},{"title":5,"description":155},1792967210806]