Add metadata field to instances

[rgarcia]

Summary

• Adds optional metadata (map of string key-value pairs) to instance creation and response
• Metadata is stored in instance config alongside environment variables and persisted to disk
• Returned in GET /instances and GET /instances/{id} responses
• Changes span domain types, API layer, generated OAPI types, and OpenAPI spec

Test plan

• Create instance without metadata — verify no regression
• Create instance with metadata: {"team": "backend", "env": "staging"} — verify stored and returned
• GET /instances — verify metadata is included in list response
• GET /instances/{id} — verify metadata is included in detail response

🤖 Generated with Claude Code

---

Note

Low Risk
Additive API field and persistence wiring with minimal impact on existing flows; main risk is backwards/forwards compatibility with clients expecting strict schemas.

Overview
Adds optional metadata (string map) to instance creation requests and persists it alongside other instance config.

Plumbs metadata through the API -> domain CreateInstanceRequest -> stored instance metadata, and returns it in instance responses when present; updates generated OAPI types and openapi.yaml to document the new field.

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

[github-actions]

✱ Stainless preview builds

This PR will update the hypeman SDKs with the following commit message.

feat: Add metadata field to instances

⚠️ hypeman-openapi studio · code

There was a regression in your SDK.
generate ⚠️

⚠️ hypeman-typescript studio · code

There was a regression in your SDK.
generate ❗ → build ✅ → lint ✅ → test ✅

npm install https://pkg.stainless.com/s/hypeman-typescript/705fa54813ccae1f18473ba4b30c27b0646519ca/dist.tar.gz

⚠️ hypeman-go studio · code

There was a regression in your SDK.
generate ⚠️ → lint ✅ → test ✅

go get github.com/stainless-sdks/hypeman-go@8ce40145c0f6db8e928efa9c2909521a6d452579

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-02-13 16:06:53 UTC