release: 0.17.0

[stainless-app]

Automated Release PR

0.17.0 (2026-04-01)

Full Changelog: v0.16.0...v0.17.0

Features

• Add scheduled instance snapshots with retention cleanup (f0d4d52)
• Add waitForState endpoint for blocking state transitions (d6cea17)
• internal: support comma format in multipart form encoding (e6abba9)

Bug Fixes

• fix issue with unmarshaling in some cases (1d74ffd)
• prevent duplicate ? in query params (6bc4417)

Chores

• ci: skip lint on metadata-only changes (e3c8b1f)
• ci: support opting out of skipping builds on metadata-only commits (c5320fd)
• client: fix multipart serialisation of Default() fields (0abcf13)
• internal: support default value struct tag (e9226b4)
• internal: update gitignore (3dbe64e)
• remove unnecessary error check for url parsing (cd07c8f)
• update docs for api:"required" (45f88d9)

---

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

---

Note

Medium Risk
Touches core request/serialization paths (apijson, apiform, requestconfig), so regressions could affect many endpoints despite being relatively contained and covered by added unit tests.

Overview
Bumps the SDK to v0.17.0 and updates release metadata/docs (CHANGELOG.md, README.md, manifest/version files, stats).

Adds new Instances capabilities: Instances.Wait (GET /instances/{id}/wait) with typed params/response for blocking on state transitions, and Instances.SnapshotSchedule with Update/Get/Delete (/instances/{id}/snapshot-schedule) plus new schedule/retention models.

Improves internal encoding/request plumbing: supports default:"..." struct tags in JSON and multipart form serialization, adds comma-style array encoding for multipart form data, fixes query string appending to avoid duplicate ?, and switches ResourceReclaimMemoryParams unmarshaling to apijson.UnmarshalRoot. CI now skips the build job for metadata-only “codegen metadata” push commits, and .gitignore adds .stdy.log.

^{Written by Cursor Bugbot for commit 43a3f9c. This will update automatically on new commits. Configure here.}

[stainless-app]

🧪 Testing

To try out this version of the SDK:

Download and unzip: 'https://pkg.stainless.com/s/hypeman-go/1d74ffdcf803144714c530ed72e6d65fba2a9b54/source.zip'. Run 'go mod edit -replace github.com/kernel/hypeman-go=/path/to/unzipped_directory'.

Expires at: Fri, 01 May 2026 08:30:35 GMT
Updated at: Wed, 01 Apr 2026 08:30:35 GMT

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[cursor]

Discarded url.Parse error risks nil pointer dereference

Low Severity

The error from url.Parse(u) is discarded with _, and the result parsed is immediately dereferenced on the next line via parsed.RawQuery. Go's url.Parse returns (nil, error) on failure (e.g., invalid percent-encoding like %zz in a user-supplied path segment), so if parsing fails, parsed will be nil and accessing parsed.RawQuery will panic. While current callers pass simple path strings that are unlikely to fail, the previous code (u = u + "?" + params) had no such risk.