release: 4.0.0

[stainless-app]

Automated Release PR

4.0.0 (2025-01-13)

Full Changelog: v3.1.1...v4.0.0

⚠ BREAKING CHANGES

• addressing: reshuffle relationship in the namespace to align with the product (#2322)
• r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2310)
• r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2309)
• r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2308)
• loa_documents: move download subresource into parent as get (#2304)
• addressing: move service bindings to dedicated namespace (#2303)
• ai: move to dedicated namespace (#2269)
• kv: move analytics under existing namespace (#2239)
• zone_transfers: move under DNS namespace (#2234)
• dnssec: move under DNS namespace (#2233)
• url_scanner: swap all methods to be v2 only (#2231)
• warp_connector: move under zero trust namespace (#2220)

Features

• addressing: move service bindings to dedicated namespace (#2303) (b9a842b)
• addressing: reshuffle relationship in the namespace to align with the product (#2322) (e6a1bfa)
• ai: add support for search endpoints and finetunes (#2305) (4493d6c)
• ai: move AI back to dedicated namespace (#2277) (674c2ce)
• ai: move to dedicated namespace (#2269) (90d0608)
• api: Add new Aegis zone setting (#2319) (dce9437)
• api: Add PATCH zone hold update method (#2268) (f21869f)
• api: api shield operations updates; rename discovery resource (#2296) (e7936f6)
• api: api update (#2124) (e03ce04)
• api: api update (#2125) (798b1a0)
• api: api update (#2126) (fe787a3)
• api: api update (#2127) (eef643f)
• api: api update (#2129) (ff2f5dc)
• api: api update (#2130) (f57867d)
• api: api update (#2131) (e077e34)
• api: api update (#2132) (f0898d4)
• api: api update (#2133) (22d878b)
• api: api update (#2135) (29e0389)
• api: api update (#2136) (b132a0d)
• api: api update (#2140) (385c772)
• api: api update (#2142) (0b5a5d0)
• api: api update (#2143) (2f10d9c)
• api: api update (#2146) (c1e8143)
• api: api update (#2147) (abbd9f7)
• api: api update (#2148) (178ca7e)
• api: api update (#2149) (b6ca4bd)
• api: api update (#2150) (99d9133)
• api: api update (#2151) (0ac8d45)
• api: api update (#2159) (1629b7f)
• api: api update (#2160) (bc2b5c4)
• api: api update (#2161) (441bcec)
• api: api update (#2162) (5244425)
• api: api update (#2163) (c2770ee)
• api: api update (#2167) (44c9de7)
• api: api update (#2168) (86eff89)
• api: api update (#2169) (94403aa)
• api: api update (#2170) (bfd27f8)
• api: api update (#2171) (f704605)
• api: api update (#2172) (abbdc97)
• api: api update (#2173) (9e7ca11)
• api: api update (#2175) (d22a2de)
• api: api update (#2179) (d39c7b5)
• api: api update (#2180) (90be13d)
• api: api update (#2181) (f3c2bb4)
• api: api update (#2188) (09acf0a)
• api: api update (#2197) (8fb8e8b)
• api: api update (#2198) (1cad830)
• api: api update (#2199) (2d5cecb)
• api: api update (#2200) (5be5fe6)
• api: api update (#2201) (dc752c1)
• api: api update (#2202) (ace26df)
• api: api update (#2203) (1c97b11)
• api: api update (#2205) (291389c)
• api: api update (#2206) (546cb1c)
• api: api update (#2209) (458a4a5)
• api: api update (#2211) (51a0005)
• api: api update (#2212) (19d7551)
• api: api update (#2216) (272e71c)
• api: api update (#2219) (88819fc)
• api: api update (#2221) (0f01824)
• api: api update (#2223) (2e9734b)
• api: api update (#2227) (ace3716)
• api: api update (#2237) (adc6f6b)
• api: api update (#2238) (84bc37c)
• api: api update (#2243) (86ca907)
• api: api update (#2244) (0978d14)
• api: api update (#2245) (c12dfc0)
• api: api update (#2247) (38a93e7)
• api: api update (#2266) (e738082)
• api: api update (#2273) (fcf96f7)
• api: api update (#2276) (d77a47e)
• api: api update (#2284) (982f95a)
• api: api update (#2285) (9cae1f0)
• api: api update (#2286) (efa8fcb)
• api: api update (#2288) (52ec839)
• api: api update (#2290) (db76849)
• api: api update (#2291) (17a3ce1)
• api: api update (#2292) (5408013)
• api: api update (#2293) (f2cdcdc)
• api: api update (#2294) (17db44d)
• api: api update (#2297) (1d4bea4)
• api: api update (#2298) (2085a9e)
• api: api update (#2299) (429c4ee)
• api: api update (#2313) (6c97352)
• api: api update (#2315) (09f456c)
• api: api update (#2317) (c6cf3dc)
• api: api update (#2318) (9229d53)
• api: api update (#2320) (bdb21a5)
• api: api update (#2343) (1bd37b9)
• api: api update (#2344) (4423d8f)
• api: api update (#2347) (8225a83)
• api: api update (#2355) (1dedfa9)
• api: clean up indirect models (#2155) (503ab54)
• api: clean up missing model references (#2138) (74f433a)
• api: clean up missing models (#2178) (bd94126)
• api: fix internal URL mappings (#2267) (165bc8c)
• api: introduce bulk operation methods (#2177) (3fd5de2)
• api: manual updates (#2164) (3f20b98)
• api: manual updates (#2195) (2de0fb0)
• api: manual updates (#2207) (d40b099)
• api: manual updates (#2226) (7065932)
• api: manual updates (#2255) (f70b142)
• api: manual updates (#2295) (a3043d4)
• api: manual updates (#2301) (91253c2)
• api: manual updates (#2302) (df84d3a)
• api: manual updates (#2312) (f7ca287)
• api: manual updates (#2325) (2a2e199)
• api: manual updates (#2326) (7e80cb8)
• api: manual updates (#2349) (878ae25)
• api: manual updates (#2351) (85fd586)
• api: map in new endpoints for account owned tokens, dns setting views and worker assets (#2144) (6e79a67)
• api: map more endpoints (#2287) (ce7f872)
• api: mark JSON as initialism (#2324) (da91e21)
• api: remap models for magic visibility (#2128) (dae1150)
• api: remove unneeded DNS transforms (#2341) (11683b6)
• api: skip authorization failures in prism (#2323) (cc90fdc)
• api: update api shield operation endpoint (#2348) (61a852b)
• api: Update verb on PATCH zone hold method (#2275) (5c57d32)
• api: update via SDK Studio (#2182) (660adfd)
• api: update via SDK Studio (#2183) (cda5a42)
• api: update via SDK Studio (#2184) (838f684)
• api: update via SDK Studio (#2185) (e727768)
• api: update via SDK Studio (#2187) (4e1d81a)
• api: update via SDK Studio (#2189) (93cfe28)
• api: update via SDK Studio (#2190) (4b59193)
• api: update via SDK Studio (#2191) (b480965)
• api: update via SDK Studio (#2192) (f1b6c86)
• api: update via SDK Studio (#2193) (d4deaed)
• api: update via SDK Studio (#2194) (9949651)
• cloud_connector: define body param name (#2314) (b04ba76)
• content_scanning: introduce support (#2254) (39bd39c)
• Delete examples/.keep (ebd0a3a)
• dex: add commands support (#2248) (8b5316e)
• dlp: disable problematic test (#2261) (560801e)
• dlp: skip tests for entries update due to HTTP 422 in prism (#2331) (0a952c0)
• dns_firewall: break out into standalone package (#2235) (34e5a29)
• dns: add models for batch operations and response (#2339) (645adba)
• dns: fix model oneOf (#2278) (e5c69df)
• dns: remove delta model (#2242) (571fe0e)
• dnssec: move under DNS namespace (#2233) (40cb3e1)
• examples: update paths to reflect namespace changes (#2334) (7af6c00)
• fix(project): constrain incompatible httpx and pydantic versions (cb5fbad)
• fleet_status: update path placeholders to match conventions (#2153) (66d6d48)
• generate more types that are used as request bodies (#2263) (acbdc24)
• iam: fix model mappings (#2154) (354f6d2)
• infrastructure_targets: add bulk endpoints (#2246) (e2f5e1b)
• internal: update path placeholders (#2224) (2cad4a0)
• kv: move analytics under existing namespace (#2239) (375bc8c)
• leaked_credential_check: add terraform resource (#2229) (2b35234)
• list_item: remove duplicated anyOf properties from component (#2342) (2a3b8c5)
• loa_documents: move download subresource into parent as get (#2304) (c10d3b7)
• origin_post_quantum_encryption: swap PUT for PATCH operation (#2321) (f6b6e83)
• pagerules: rename namespace to page_rules (#2262) (72b7def)
• python: expand model_type rename to paths as well (#2156) (9abf6d5)
• r2_bucket: add cors support (#2196) (8ed5f71)
• r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2308) (5dfdcbd)
• r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2309) (fd63955)
• r2: rename cf-r2-jurisdiction to more usable jurisdiction parameter (#2310) (a1ef1be)
• release: 3.1.1 (6a4602a)
• swap DNS example to A (792e093)
• tokens: move condition and policy to shared models (#2158) (f92d492)
• tokens: move token value model to shared (#2157) (8c246c1)
• url_scanner: swap all methods to be v2 only (#2231) (3823729)
• urlscanner: swap to v2 create (#2225) (c04d762)
• warp_connector: move under zero trust namespace (#2220) (de07ba2)
• workers: add routes support (#2279) (0991241)
• zero_trust_device_certificates: update path placeholders (#2204) (f43f392)
• zero_trust_device: reshuffle structure to allow use of custom and default (#2137) (e323e62)
• zero_trust_organization: swap to upsert for creation (#2186) (eeb6d8e)
• zone_settings: update origin_max_http_version model (#2311) (20fbd7d)
• zone_transfers: move under DNS namespace (#2234) (c3cd782)

Bug Fixes

• api: better support union schemas with common properties (#2340) (e6ff06c)
• client: compat with new httpx 0.28.0 release (#2228) (a369813)
• client: only call .close() when needed (#2330) (349d7af)
• correctly handle deserialising cls fields (#2350) (a1e865f)
• example: update example to reflect new structure (d723b37)
• internal: add cleaner handling of DNS unions (#2270) (582142f)
• project: constrain incompatible httpx and pydantic versions (00f4d23)
• types: correct forward usage (41a2158)
• types: work around cyclical import error (10e2b12)
• urlscanner: fix invalid schema definition for plain text (#2256) (db72d31)
• waiting_room_rules: define body_param_name for bulk rules endpoint (#2139) (a88b77d)

Reverts

• fix(project): constrain incompatible httpx and pydantic versions (4823b68)

Chores

• add missing isclass check (#2316) (a271105)
• examples: fix DNS record example (520a260)
• fix cyclical imports (#2353) (7f83adf)
• internal: add support for TypeAliasType (#2265) (f68f721)
• internal: bump httpx dependency (#2328) (799c954)
• internal: bump pydantic dependency (#2251) (ff3807c)
• internal: bump pyright (#2232) (7d503e6)
• internal: bump pyright (#2264) (72e5f89)
• internal: codegen related update (#2176) (c810755)
• internal: codegen related update (#2213) (5bf1ef5)
• internal: codegen related update (#2214) (515e68c)
• internal: codegen related update (#2217) (09de961)
• internal: codegen related update (#2218) (55b8cff)
• internal: codegen related update (#2230) (1156419)
• internal: codegen related update (#2253) (89e9982)
• internal: codegen related update (#2282) (712c994)
• internal: codegen related update (#2289) (9cb1e41)
• internal: codegen related update (#2300) (73ec2ba)
• internal: codegen related update (#2327) (ff79b8b)
• internal: codegen related update (#2337) (e0e0068)
• internal: exclude mypy from running on tests (#2222) (ee088e9)
• internal: fix formatting (a824f1b)
• internal: fix some typos (#2283) (6b98f7a)
• internal: remove some duplicated imports (#2272) (2fe9a70)
• internal: skip broken tests (#2345) (9228d48)
• internal: updated imports (#2274) (352b69d)
• make the Omit type public (#2241) (4b2bf34)
• rebuild project due to codegen change (#2134) (fdc0bb6)
• rebuild project due to codegen change (#2141) (1914be1)
• rebuild project due to codegen change (#2145) (6473ee6)
• rebuild project due to codegen change (#2165) (877e8c2)
• rebuild project due to codegen change (#2174) (dbebda3)
• remove now unused cached-property dep (#2208) (9218b3b)
• small refactors (#2306) (8edd6d6)
• switch to TypeAliasType for request tracer (332f48d)
• updates (#2260) (d2f86b6)
• updates (#2352) (b241f5b)
• use TypeAliasType for Pydantic v2 only (da884ff)
• workaround circular import error (#2210) (eb4ca16)

Documentation

• api.md: fix return type annotations (#2215) (ce08157)
• fix typos (#2336) (5a0030a)
• readme: example snippet for client context manager (#2280) (54e1a34)
• readme: fix http client proxies example (#2252) (3f9fd35)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🤖 Release is at https://github.com/cloudflare/cloudflare-python/releases/tag/v4.0.0 🌻