Skip to content

fix: add missing response examples across HW-Reg endpoints#667

Merged
BrentIO merged 2 commits into
mainfrom
worktree-agent-a233e2407ee6919fd
Jun 21, 2026
Merged

fix: add missing response examples across HW-Reg endpoints#667
BrentIO merged 2 commits into
mainfrom
worktree-agent-a233e2407ee6919fd

Conversation

@BrentIO

@BrentIO BrentIO commented Jun 21, 2026

Copy link
Copy Markdown
Owner

Multiple endpoints had no complete response examples. Added realistic examples for:

  • GET /api/network — array of four interface objects (ethernet, wifi, wifi_ap, bluetooth)
  • GET /api/network/{interface} — single interface object; improved 404 description to "Interface not found"
  • GET /api/identity — full identity object with uuid, product_id, product_hex
  • GET /api/mcu — complete mcuInfo object with realistic ESP32 chip values
  • GET /api/partitions — four-entry partition array (nvs, otadata, app, ui)
  • GET /api/peripherals — four-entry peripheral array covering all non-NVS types
  • GET /api/version — complete applicationVersionInfo object

Bodyless responses (POST /api/identity 201, POST /api/mcu/reboot 204, POST /api/registration 204) already had descriptions and required no changes.

Closes #619

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Comment thread Hardware-Registration-and-Configuration/openapi.yaml Outdated
Previous UUID had version nibble 7; corrected to version 4.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@BrentIO BrentIO merged commit 90d0374 into main Jun 21, 2026
2 checks passed
@BrentIO BrentIO deleted the worktree-agent-a233e2407ee6919fd branch June 21, 2026 20:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

HW-Reg spec: multiple endpoints missing response examples

1 participant