Skip to content

Fix incorrect OpenAPI docs for POST /v1/project WRT parent semantics - #7312

Merged
nscuro merged 1 commit into
DependencyTrack:mainfrom
nscuro:issue-7243
Sep 14, 2026
Merged

nscuro merged 1 commit into
DependencyTrack:mainfrom
nscuro:issue-7243

Conversation

@nscuro

@nscuro nscuro commented Sep 14, 2026

Copy link
Copy Markdown
Member

Description

Fixes incorrect OpenAPI docs for POST /v1/project WRT parent semantics.

The description incorrectly claimed that omitting parent would leave it in place (which is the behavior of PATCH), whereas doing so in reality caused the parent to be removed.

The functionality itself is intentional since there's no other way to remove a parent, so this change just fixes the docs and adds a test that locks the behavior.

Addressed Issue

Fixes #7243

Additional Details

N/A

Checklist

  • I have read and understand the contributing guidelines
  • This PR fixes a defect, and I have provided tests to verify that the fix is effective
  • This PR implements an enhancement, and I have provided tests to verify that it works as intended
  • This PR introduces changes to the database model, and I have updated the migration changelog accordingly
  • This PR introduces new or alters existing behavior, and I have updated the documentation accordingly
  • This PR is a substantial change (per the ADR criteria), and I have added an ADR under docs/adr/

The description incorrectly claimed that omitting `parent` would leave it in place (which is the behavior of `PATCH`), whereas doing so in reality caused the parent to be removed.

The functionality itself is intentional since there's no other way to remove a parent, so this change just fixes the docs and adds a test that locks the behavior.

Signed-off-by: nscuro <nscuro@protonmail.com>
@nscuro nscuro added this to the 5.2 milestone Sep 14, 2026
@nscuro nscuro added defect Something isn't working backport/5.1.1 labels Sep 14, 2026
@owasp-dt-bot

Copy link
Copy Markdown

✅ Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
✅ Open Source Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

@codacy-production

codacy-production Bot commented Sep 14, 2026 •

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Metrics 0 complexity

Metric Results
Complexity 0

View in Codacy

🟢 Coverage ∅ diff coverage · +0.00% coverage variation

Metric Results
Coverage variation ✅ +0.00% coverage variation (-1.00%)
Diff coverage ✅ ∅ diff coverage (70.00%)

View coverage diff in Codacy

Coverage variation details
Coverable lines Covered lines Coverage
Common ancestor commit (47a52c2) 44554 38931 87.38%
Head commit (6d0287a) 44554 (+0) 38932 (+1) 87.38% (+0.00%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details
Coverable lines Covered lines Diff coverage
Pull request (#7312) 0 0 ∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@nscuro
nscuro merged commit f385706 into DependencyTrack:main Sep 14, 2026
22 of 23 checks passed
@nscuro
nscuro deleted the issue-7243 branch September 14, 2026 12:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

defect Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

OpenApi inconsistence about handling parent relationship on POST /v1/project

2 participants