[VIRTS-2887] Update Swagger Docs

[bleepbop]

Description

Updated swagger docs for several APIs. Some objects only require certain schema fields, so the aiohttp request schemas have been updated to show this. aiohttp_apispec issues a warning when the exclude/include parameters are added to the request schema, however this has no side effect on the actual API functionality, so those warnings have been silenced in server.py. Lastly, some schemas do not allow for excluding/including certain fields (the adjustments field in the Source schema, to be specific), so APIs relying on said schemas will have summaries indicating fields that can be excluded/included.

Type of change

• New feature (non-breaking change which adds functionality)

How Has This Been Tested?

Verified request schemas work with Pytest.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have made corresponding changes to the documentation
• [NA] I have added tests that prove my fix is effective or that my feature works

[codecov]

Codecov Report

Merging #2324 (3428114) into master (cc8d071) will decrease coverage by 0.01%.
The diff coverage is 85.71%.

@@            Coverage Diff             @@
##           master    #2324      +/-   ##
==========================================
- Coverage   72.62%   72.60%   -0.02%     
==========================================
  Files         110      110              
  Lines        7942     7944       +2     
==========================================
  Hits         5768     5768              
- Misses       2174     2176       +2     

Impacted Files	Coverage Δ
server.py	0.00% <0.00%> (ø)
app/api/v2/handlers/ability_api.py	96.22% <100.00%> (ø)
app/api/v2/handlers/adversary_api.py	96.49% <100.00%> (ø)
app/api/v2/handlers/agent_api.py	97.01% <100.00%> (ø)
app/api/v2/handlers/fact_source_api.py	96.22% <100.00%> (ø)
app/api/v2/handlers/objective_api.py	100.00% <100.00%> (ø)
app/api/v2/handlers/operation_api.py	98.70% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update cc8d071...3428114. Read the comment docs.

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.0% Duplication