SOLR-18152: improve body format OpenAPI annotations to fully communicate SchemaDesigner API

[epugh]

https://issues.apache.org/jira/browse/SOLR-18152

Description

During integration of SchemaDesigner V2 APIS into Admin UI, it was flagged that we don't properly document the addField / add-field commands.

Before today's fix, the generated JS/SolrJ clients would have sent {"addField": {...}} (camelCase) , but the server doesn't consume that, it consumes add-field.

Solution

Now we do:

curl -X POST "http://localhost:8983/api/schema-designer/mySchema?schemaVersion=3" \
  -H "Content-Type: application/json" \
  -d '{
        "add-field": {
          "name": "keywords",
          "type": "string",
          "stored": true,
          "indexed": true
        }
      }'

This applies to add-dynamic-field, add-copy-field, add-field-type as well!

Tests

Manual and unit

[gerlowskija]

LGTM

[epugh]

Woot! thanks @gerlowskija this unblocks the last steps in SchemaDesigner to v2 work!

[Copilot]

🟡 Changes recommended

The template change can generate references to nonexistent Java model members.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Improves Schema Designer OpenAPI contracts and generated-client request handling.

Changes:

• Exposes kebab-case add-operation keys.
• Documents dynamic request properties.
• Updates generated SolrJ setters and round-trip coverage.

File summaries

File	Description
solr/solrj/src/resources/java-template/api.mustache	Updates generated request setters.
solr/core/src/test/org/apache/solr/handler/designer/TestSchemaDesignerSolrJ.java	Exercises dynamic update properties.
solr/api/src/java/org/apache/solr/client/api/model/UpsertFieldTypeOperation.java	Documents open-ended field-type attributes.
solr/api/src/java/org/apache/solr/client/api/model/UpsertFieldOperation.java	Documents open-ended field attributes.
solr/api/src/java/org/apache/solr/client/api/model/UpsertDynamicFieldOperation.java	Documents open-ended dynamic-field attributes.
solr/api/src/java/org/apache/solr/client/api/model/SchemaDesignerUpdateRequestBody.java	Exposes arbitrary update properties in OpenAPI.
solr/api/src/java/org/apache/solr/client/api/model/SchemaDesignerAddRequestBody.java	Exposes kebab-case operation names.
solr/api/src/java/org/apache/solr/client/api/endpoint/SchemaDesignerApi.java	Enables generated dynamic-property setters.

Review details

• Files reviewed: 8/8 changed files
• Comments generated: 1
• Review effort level: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[epugh]

Okay, once I get a good CI build I plan on merging htis.

[Copilot]

🟡 Changes recommended

The generated JavaScript add-field regression path lacks automated coverage.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

• Files reviewed: 16/16 changed files
• Comments generated: 1
• Review effort level: Balanced