Common patterns
How to read a pattern
- The outer
RequiredorOptionalexpression describes presence. - The inner expression describes the expected value type.
- A condition inside the type expression describes validation.
- The
P...variable names correspond to values consumed by the resource implementation; the JSON field names come from the operation’s documented request schema.
Canonical application contract
Application developers should use the generated OpenAPI schema for exact JSON field names, types, and required properties. Pattern notation remains documented so legacy examples and implementation-oriented reference material can be interpreted correctly. Do not translate these expressions intoGET /v1/...?... filters. The Agent API publishes resources below /Agent and normally uses POST unless an individual resource states otherwise.