2026-10-07

Version dates

  • 2026-10-06 - a new dated response version for GET /v1/monitors/{id}. When an account is enabled, selecting this date returns the full Monitor-Resource shape with the monitor query, rules, scheduling, groupings, service bindings, actions, and derived state. The versioned response is alpha and returns 403 until the account is enabled; callers without the header continue to receive the stable default response.

Breaking changes

  • GET /v1/monitors/{id} operation identifier renamed from getMonitor to GetMonitor. Generated clients may rename the corresponding method; raw HTTP callers are unaffected.
  • GET /v1/monitors/{id} path parameter id is now modeled as a string with format: int64 instead of an integer. The URL value remains textual on the wire, but generated clients may need to change the parameter type before selecting the versioned response.

Deprecations

  • label in Monitor-Brief and Monitor-ListItem is deprecated in favor of name. The response continues to include label for compatibility; clients should read name instead.

Migration

1. Regenerate generated clients and update the monitor-get method and ID type:

- monitor := client.getMonitor(41000123)
+ monitor := client.GetMonitor("41000123")

Raw HTTP callers do not need to change the method or path. The default response remains stable when no Observe-Api-Version header is sent.

2. Opt into the new response only after the account is enabled:

Observe-Api-Version: 2026-10-06

A 403 means the account has not been enabled yet; retry the request without the header to use the stable response.

3. Replace deprecated monitor labels:

BeforeAfter
monitor.labelmonitor.name
monitor.record.labelmonitor.record.name

Clients that only use raw HTTP and do not depend on generated model names or typed parameter signatures do not need to change code for the operation rename or the string representation of the path ID.