Operation build example

[maishanisa1]

What/Why/How?

Reference

Testing

Screenshots (optional)

Check yourself

• Code is linted
• Tested with redoc/reference-docs/workflows (internal)
• All new/updated code is covered with tests

Security

• Security impact of change has been considered
• Code follows company security practices and guidelines

[lornajane]

Please don't update this file when making other changes.

[lornajane]

Thanks for adding a prices feature to the API. There are a few things in this pull request to improve before we are ready to merge. First of all: please complete the pull request template and update the pull request title to explain what this pull request does and why it matters.

In design terms, would be better to re-use parameters wherever possible, otherwise the API design can easily lose consistency. For these *2 entries, it looks like the only change is the description. Instead of duplicating the parameter, consider either:

• making the parameter description generic enough that it makes sense in multiple contexts.
• adding a description alongside $ref if a specific description is needed.