Fixes #22303: Annotate fields & omit parameters in OpenAPI schema

[jeremystretch]

Fixes: #22303

Extend NetBoxAutoSchema to annotate the optional fields and omit query parameters.

[jeremystretch]

@claude /review Only report on issues of potential concern; we don't need commentary on anything that doesn't require further consideration.

[github-actions]

Claude finished @jeremystretch's task in 1m 5s —— View job

---

PR Review

One potential concern:

Comment mentions ?brief but it's not implemented (schema.py:279)

The inline comment reads:

# Expose the ?fields, ?omit, and ?brief query parameters supported by NetBoxModelViewSet

But only fields and omit are added as OpenApiParameter entries — brief is absent from the implementation. Since brief is a real supported parameter (set in BaseViewSet.initialize_request), either:

• The comment should drop the mention of ?brief (if the omission is intentional), or
• A brief parameter entry should be added alongside fields and omit

Fix this →

[jeremystretch]

Addressed the above.

Didn't update contrib/openapi.json as part of this PR (that will happen during the release process), but did verify that it makes the intended changes.