release: 0.17.0

[stainless-app]

Automated Release PR

0.17.0 (2026-03-28)

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

• 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
Medium risk because it adds new Instances APIs and modifies shared request/encoding internals (query-string composition, multipart/JSON default handling), which could affect request serialization across the SDK.

Overview
Bumps the SDK to v0.17.0 (manifest/internal version, README install snippet, changelog/stats) and tweaks CI to skip the build job for push commits with message codegen metadata.

Adds new Instances capabilities: a blocking Instances.Wait (GET /instances/{id}/wait) with InstanceWaitParams/WaitForStateResponse, plus a new Instances.SnapshotSchedule subservice (PUT/GET/DELETE /instances/{id}/snapshot-schedule) with schedule/retention request+response types.

Updates internal serialization: requestconfig now appends query params with & when the URL already has a query string, apiform supports comma-form arrays and a string default:"..." struct tag (with tests), and apijson gains the same default tag support for JSON marshaling.

^{Written by Cursor Bugbot for commit c477630. 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/45f88d9c8507e0c6aa729d52a69d58041d0dd3db/source.zip'. Run 'go mod edit -replace github.com/kernel/hypeman-go=/path/to/unzipped_directory'.

Expires at: Mon, 27 Apr 2026 07:19:40 GMT
Updated at: Sat, 28 Mar 2026 07:19:40 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.