Skip to content

add PUT/POST/DELETE for monitoring-sets - #257

Merged
catkins-miso merged 5 commits into
1.0from
modify-monitoring-sets
Feb 19, 2026
Merged

catkins-miso merged 5 commits into
1.0from
modify-monitoring-sets

Conversation

@catkins-miso

@catkins-miso catkins-miso commented Jan 21, 2026 •

Copy link
Copy Markdown
Contributor

closes #254

@getorymckeag please review this at your convenience. In particular, I would call your attention to the rationale for the minor version change. Requiring name for a monitoring set media type would have been a breaking change, so we now have a v2 monitoring set media type. The commit history says it all.
https://trolie.energy/decision-log/media-type-versioning.html#media-type-versions

@catkins-miso

Copy link
Copy Markdown
Contributor Author

Feedback from call:

  • Need a way to get the id back instead of 201
  • Rename the new media type to "monitoring set representation"
  • Add required Name
  • Documentation
    • Justify the agnostic approach to monitoring set identity
    • highlight the aliasing using alternate idents
    • 422 documentation that you can't monitor non-existent resources
    • affirmative negative: the spec doesn't assume that user-defined ids are permitted, so it remains silent on the response to a request that would re-create an existing monitoring set

This means adding a new media type for the monitoring set representation, since requiring name in the current v1 media type would be a breaking change. Per the [Media Type Versioning ADR](https://trolie.energy/decision-log/media-type-versioning.html), this requires updating the minor version of the TROLIE spec itself.
@catkins-miso

Copy link
Copy Markdown
Contributor Author

@getorymckeag @aidan-short-gevernova bump, can I get a review please?

@catkins-miso
catkins-miso merged commit 8857b33 into 1.0 Feb 19, 2026
3 checks passed
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.

Add ability to update monitoring sets

3 participants